handshake-org/hsd

Package Level READMEs

Open

#116 创建于 2019年3月22日

在 GitHub 查看
 (1 评论) (1 反应) (0 负责人)JavaScript (1,814 star) (286 fork)batch import
Good first issuepkg

描述

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

贡献者指南