This is the Antora playbook project (site build) for the Redpanda docs site published at docs.redpanda.com.
The playbook, antora-playbook.ymlconfigures the production build for the docs site.
This playbook tells Antora what documentation to assemble, where to find it, and what UI to apply to it.
The documentation is hosted in a separate Git repository, as is the UI project, and the custom extensions.
The production site is built for each change to the main branch.
A deploy preview of the site is also published for each pull request.
|
Tip
|
For an introduction to Antora and helpful tips for getting started with local development, see the Contributing guide. |
The playbook pulls content from branches in the github.com/redpanda-data/documentation repository.
Redpanda core documentation is stored in versioned branches prefixed with v/.
For more details, see the README.
The Redpanda docs site includes custom extensions and macros to enhance the site and provide custom features.
For details about all the extensions and macros, see github.com/redpanda-data/docs-extensions-and-macros.
The docs site is hosted on Netlify.
The Netlify build is configured in the netlify.toml file. The redirects in this file redirect users from the previous Docusaurus URLs to the new Antora ones.
|
📎
|
When you delete, rename, or move an existing page, use the page-aliases attribute. Do not use the netlify.toml file. The redirects in this file must be bulk URL redirects, such as removing or renaming a component or component version.
|
For details about this file, see the Netlify documentation.
To learn how to use the playbook and generate the docs site locally, see our contributing guide.