Create release notes from changelogs
By adding a file for each notable change in your GitHub repository and grouping the files into bundles, you can ultimately generate release documentation with a consistent layout for all your products.
To use the docs-builder changelog commands in your development workflow:
- Configure changelogs: Create a configuration file, map labels, and define rules for creation and bundling.
- Create changelogs with the
docs-builder changelog addcommand.- Alternatively, if you already have automated release notes for GitHub releases, you can use the
docs-builder changelog gh-releasecommand to create changelog files and a bundle from your GitHub release notes. Refer to changelog gh-release.
- Alternatively, if you already have automated release notes for GitHub releases, you can use the
- Bundle changelogs with the
docs-builder changelog bundlecommand. For example, create a bundle for the pull requests that are included in a product release. When changelogs are no longer needed in the repo, remove changelog files withdocs-builder changelog remove. - Publish release notes: Use the
{changelog}directive in docs ordocs-builder changelog renderto produce release documentation.
For more information about running docs-builder, go to Contribute locally.