Standard Readme Style
积累经验！
This repository contains:
- The specification for how a standard README should look.
- A link to a linter you can use to keep your README maintained (work in progress).
- A link to a generator you can use to create standard READMEs.
- A badge to point to this spec.
- Examples of standard READMEs - such as this file you are reading.
Standard Readme is designed for open source libraries. Although it’s historically made for Node and npm projects, it also applies to libraries in other languages and package managers.
Standard Readme started with the issue originally posed by @maxogden over at feross/standard in this issue, about whether or not a tool to standardize readmes would be useful. A lot of that discussion ended up in zcei's standard-readme repository. While working on maintaining the IPFS repositories, I needed a way to standardize Readmes across that organization. This specification started as a result of that.
Your documentation is complete when someone can use your module without ever having to look at its code. This is very important. This makes it possible for you to separate your module's documented interface from its internal implementation (guts). This is good because it means that you are free to change the module's internals as long as the interface remains the same.
This project exists thanks to all the people who contribute.
MIT © Richard Littauer