...
- Purpose of the project so that users can understand what the project is about, enhancing user experience.
- Describe how to use the project, the mechanism, and the functionalities of various features. Make the reader understand the technology, before using it. Gives instructions on how to do the specific task. It consists of steps that need to be followed.
- Provide relevant links, code snippets, and algorithms.
- Provide images, graphics, tables, flow charts, user flow, etc.
- Feedback from users
- Conclusion and people to contact for more information (maintainers, project mentor)
Resources:
Best Practices Badges / Templates
Created a pull request template: https://github.com/hyperledger-labs/documentation-template/pull/12 (merged)
...
As I am the Committee Chair for Templates. I will be focusing and working on templates for GitHub and documentation.
Reference
Best Practices Badges / Templates