Contents
This is the Antora playbook project (site build) for the Redpanda docs site published at docs.redpanda.com.
Playbook
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 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. |
Content sources
Redpanda core docs
Redpanda core documentation is stored in versioned branches prefixed with v/.
For more details, see the README.
Extensions and macros
The Redpanda docs site includes custom extensions and macros to enhance the site and provide custom features.
Netlify configuration and redirects
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.
|
Contributing
To learn how to use the playbook and generate the docs site locally, see our contributing guide.