Provides an example readme template to bootstrap documentation.
Start with one sentence explaining what the repository does. Avoid mentioning the technology used, its rationale, or tech jargon. This sentence should be understandable by a non-technical audience.
Describe the development environment. Include basic instructions--does this repository prefer npm ci or npm i? Does prettier run on save? Any special settings or extensions you should set up in your IDE?
Include any environment variables or configuration required.
If you're not sure where to start, consider explaining the npm scripts that might be relevent for getting a development environment
Be sure to include any system level dependencies, even if they are shared with many projects. Do I need Transit APIs running? Redis? Docker?
How can I put this on staging or production? If automated, place a link to the cloud build trigger.
Include a quick overview of how the project is organised. If it follows a pattern, include a link to the Wikipedia article (ie: "This project is organised following the principles of Domain Driven Design, where it makes sense").
Are you consuming an entity that follows a documented specification? Include a link to the specification (ie gbfs or gtfs).
- Write in simple English.
- Prefer lists when appropriate.
- Include links to third party resources.