The Redpanda docs are open source, and we welcome your contributions!
Before you add or edit content, consult the Redpanda Style Guide for product documentation guidelines.
To contribute to the Redpanda docs, you have the following options:
Option | Description |
---|---|
Suggest a change by opening an issue on GitHub. |
|
Make changes directly to the documentation and submit them through a pull request. |
The Redpanda docs team uses GitHub issues to track, plan, and prioritize tasks. To suggest changes, you can create an issue, which the team will then evaluate:
-
Verify whether a similar issue already exists in that repository to avoid duplication.
-
Go to Issues > New Issue to create a new issue.
You have the option to assign the issue to yourself or leave the assignee field blank. The Redpanda docs team triages all new issues and will allocate a writer if one isn’t already assigned.
If you are a Redpanda employee, submit doc issues in redpanda-data/documentation-private
.
You have two options to contribute to the documentation:
-
Directly edit a page on GitHub by selecting Make a contribution > Edit on GitHub located at the bottom of a documentation page.
-
Clone the docs repository to make changes locally on your machine. For a guide, see Submit your first contribution.
Check the open docs issues. If you find an issue you’d like to work on:
-
If the issue is already assigned to someone else, please consider another one.
-
If the issue is unassigned, add a comment expressing your interest in working on it.
If you want to run the website locally, install and update the packages:
npm update
Then, build the docs and start a local web server:
npm run start
This command opens a browser window. Most changes are reflected live without having to restart the server.
Versioned content is stored in branches that track the version of Redpanda Self-Managed. Production branches use the v/x.y naming pattern. For example, branch v/22.3
hosts the content for version 22.3.x of Redpanda Self-Managed. The main
branch always contains docs for the latest release.
The production docs site playbook instructs Antora to automatically aggregate content in the following branches:
-
main
: Content for the latest version of Redpanda. -
v/*
: Content for previous versions of Redpanda. -
shared
: Content that is shared across all versions (asciidoc attributes and terms) -
api
: API docs as well as the source OpenAPI spec files. -
site-search
: The global site search page.
The documentation content is stored in the modules/
directory, where each module represents a top-level label in the documentation nav tree.
Each module has a pages/
directory that stores the documentation pages in Asciidoc format. Some modules also include a partials/
directory that contains single-sourced documentation that can be shared and referenced by any documentation pages across any module.
The shared
module stores the images, attachments, and partials that do not belong to a single module and can be referenced by any documentation pages across any module.
modules/shared ├── attachments ├── images └── partials