Interested projects
Monday
- Goals for each sub-committee
I am documenting my progress as the Best Practices Lead here.
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.
Tuesday 11 July 2023
Goals for Best Practices sub-committee
...
- 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.
Monday
- Goals for each sub-committee