-
-
Notifications
You must be signed in to change notification settings - Fork 16.7k
README template
Rand McKinney edited this page Feb 16, 2017
·
3 revisions
Use this template to create a README file for a new module. To use it, copy/paste the markdown below into your README.md file. Follow the detailed README guidelines to fill in the sections.
# module-name **Badges** Optional badges such as npm version, test and build coverage, and so on. **Summary** One- or two-sentence description of what the module does. ## Overview Optionally, include a section of one or two paragraphs with more high-level information on what the module does, what problems it solves, why one would use it and how. Don't just repeat what's in the summary. ## Installation ``` $ npm install module-name ``` ## Basic use General description of how to use the module with basic example. ## API Full API documentation. ## Examples Additional examples here. ## Tests What tests are included and how to run them. ## Contributing This project welcomes contributions from the community. Contributions are accepted using GitHub pull requests; for more information, see [GitHub documentation - Creating a pull request](https://help.github.com/articles/creating-a-pull-request/). For a good pull request, we ask you provide the following: 1. Include a clear description of your pull request in the description with the basic "what" and "why"s for the request. 2. The tests should pass as best as you can. GitHub will automatically run the tests as well, to act as a safety net. 3. The pull request should include tests for the change. A new feature should have tests for the new feature and bug fixes should include a test that fails without the corresponding code change and passes after they are applied. The command `npm run test-cov` will generate a `coverage/` folder that contains HTML pages of the code coverage, to better understand if everything you're adding is being tested. 4. If the pull request is a new feature, please include appropriate documentation in the `README.md` file as well. 5. To help ensure that your code is similar in style to the existing code, run the command `npm run lint` and fix any displayed issues. ## Contributors Names of module "owners" (lead developers) and other developers who have contributed. ## License Link to the license, with a short description of what it is, e.g. "MIT" or whatever.