PRDoc
prdoc
is a tool designed to help generating, checking and loading .prdoc
files.
.prdoc
files are YAML files adhering to defined JSON schema and helping with code change documentation.
It allows structuring the documentation per project, checking contributions for adherence to the structure, validating the content, and generating better quality release notes.
It is used by the Polkadot-sdk repository.
1. Features
-
Generate Documentation: Automatically generate documentation files based on your project’s codebase.
-
Check Documentation: Validate existing documentation files against a predefined JSON schema to ensure consistency and correctness.
-
Load Documentation: Easily load and parse
.prdoc
files for use in your projects.
cargo install prdoc
More on the project can be found on the GitHub repository.