handshake-org/hsd

Package Level READMEs

Open

#116 aberto em 22 de mar. de 2019

Ver no GitHub
 (1 comment) (1 reaction) (0 assignees)JavaScript (286 forks)batch import
Good first issuepkg

Métricas do repositório

Stars
 (1.814 stars)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

It would be really helpful to have a high level README.md for each package in the lib directory. These could contain a high level overview of the package, including the exports, the classes and their methods, what the package does and any other information that would make understanding the package easier for people. A good example could be found in btcd, where they document each package with a README.md. See this link for an exact example: https://github.com/btcsuite/btcd/tree/master/mempool

Desired information in a lib/{package}/README.md:

  • Classes/functions exported
  • Class methods
  • Minimal amount of configuration to instantiate a Class
  • High level overview of the package itself

Feel free to chime in with any additional thoughts/opinions in what would make these READMEs more useful

Guia do colaborador