...
- Use of accepted Style Guide.
- Accurate and evergreen content.
- Prior audience analysis.
- Solves a specific problem.
- Follows grammatical rules and punctuation.
- Concise and easy-to-understand content.
- High-quality visual representation.
- Provides links to sources.
- Use of appropriate sections, headings, fonts, lists, and whitespaces - the document is skimmable.
- Engaging and user-friendly content.
- Use of active voice.
Friday
Situation
The Documentation Task Force aims at establishing consistent and comprehensive documentation standards for the community platforms.
Task
As the Best Practices sub-committee, our task is to standardize documentation and enhance overall project efficiency across the Foundation.
Action
- Conduct extensive analysis of existing practices and also identify areas of inconsistency and inefficiency.
- Collaborate with key stakeholders, including developers, maintainers, and community members, to gather insights, requirements, and feedback.
- Research industry best practices and identify suitable methodologies, tools, and frameworks that could be adopted within the Hyperledger ecosystem.
- Develop comprehensive documentation, guidelines, and templates covering documentation processes and version control.
- Organize training sessions and webinars to educate community members on the newly established best practices and encourage their adoption.
- Regularly monitor and assess the implementation of best practices, collecting feedback and addressing any issues or concerns.
Result
- Improve consistency and efficiency in documentation processes across projects.
- High-quality documentation that is accurate, accessible, and easy to understand, thus attracting more contributors and expanding the user base.