3/20/23

Tasks 

Task 1:

Common styling guide:
Develop a styling guide that outlines the formatting, structure, and language that should be used in all Hyperledger technical documentation.

Task 2

Recommended common publishing platform:
Identify and recommend a publishing platform that projects can use to publish their documentation. This will help ensure consistency across projects and make it easier for users to find the information they need.

Task 3

Document best practices for creating documentation:
Create a document that outlines best practices for creating technical documentation, including information on tooling and how to target different audiences.

Task 4

Create a template repo that new projects can use for creating their documentation:
Create a template repository that new projects can use to create their documentation. This should include the

Task 5

Best Practices for creating Documentation:
Develop best practices for creating technical documentation. This should include guidelines for using appropriate language, structure, and formatting, as well as how to present complex technical concepts to different audiences. Additionally, it should provide guidance on the use of visual aids such as diagrams and screenshots.

Task 6

Available Community Resources:
Identify and compile a list of resources available to the community that can assist in creating documentation. This can include tools such as style guides, publishing platforms, and tutorials.

Task 7 Audience Specific Training Materials:
Documentation should be tailored to specific audiences, such as developers or users. Develop training materials specific to these audiences to help them understand and utilize the documentation effectively.

Task 8  Documentation "badge":
Develop a checklist that projects can use to ensure that their documentation meets the established standards. Projects that meet these standards can be recognized with a "Documentation Badge."

Task 9

New Project Guidelines:
Create guidelines for new projects that outline the documentation requirements they need to meet. This should include guidance on how to structure documentation, what types of content are required, and how to use the recommended tooling.

Task 10 Existing Project Updates:
Review and update the documentation for existing projects to meet the established standards. This will ensure that the entire Hyperledger community has access to high-quality technical documentation.

3/15/23

Mentorship Application

Hyperledger Documentation Standards

3/13/23

Introduction

The mission of the Documentation Standards Taskforce is to establish consistent and comprehensive documentation standards for the Hyperledger Foundation open-source blockchain platforms. Our goal is to provide developers, users, and other stakeholders with high-quality technical documentation that is accurate, accessible, and easy to understand. Our end goal is to ensure that the technical documentation for the Hyperledger community is of the highest quality, making it easier for developers to build on these platforms and for users to understand and utilize them effectively.  Therefore, we aim to develop a set of standards that will be suggested to the Hyperledger projects that utilize the tools available to the community while also considering each project's unique features and characteristics. The purpose of this tone is to recognize that each Hyperledger project has a different team, with different maintainers who create and update documentation pages. Our task force will evaluate the current documentation environment and work collaboratively to establish standards and training materials and make the community aware of available resources. 

...