-
Notifications
You must be signed in to change notification settings - Fork 130
README files
Barrie Byron edited this page Jul 11, 2023
·
7 revisions
README files are the welcome sign for the project and form the first impression of the project for new users and potential contributors.
The README content keeps essential information close to the code and signals that a community is active. A quality README elevates the quality of any project and shares information that makes the project more attractive to contributors.
- Title
- A few short statements describing why your project exists and what it does
- Installation and dependencies
- Usage instructions
- How users can get help
- Links to essential documentation
- Use absolute links so that the links work on npm
- Link to your project's license
- Table of contents
- Tech stack and features
- A link to a working instance
- A screenshot of the project's user interface
- Link to contributing guidelines
- Link to code of conduct
- Badges
- Tests
- Code examples and how to run them