Centralized publication¶

Projects published from scylladb-docs-homepage¶

The following projects are published from the scylladb-docs-homepage repository to the docs.scylladb.com domain:

• ScyllaDB Homepage: Published every time there is a new commit on the main branch.

• ScyllaDB Manual: Published every 24 hours or whenever the file manual_doc_versions.json receives an update.

Projects defining versions in scylladb-docs-homepage¶

The following projects define their versions in the scylladb-docs-homepage repository:

• ScyllaDB Homepage: conf.py

• ScyllaDB Manual: manual_doc_versions.json

• ScyllaDB Open Source: opensource_doc_versions.json

• ScyllaDB Enterprise: enterprise_doc_versions.json

List a new version¶

To add a new release to the centralized publication, submit a pull request to the scylladb/scylladb-docs-homepage repository with the following changes:

1. Open the docs/_static/data/ directory.

2. Update the <PROJECT_NAME>_doc_versions.json file. Add the new version to the branches array:

    {
        "tags": [],
        "branches": [
            "master",
            "branch-2025.1",
            "branch-2025.2"
        ],
        "latest": "branch-2025.1",
        "unstable": ["master"],
        "deprecated": []
    }
   

   Note

   The branch should already exist in the associated project repository.

3. In the same file, set the new version as the latest:

    {
        "tags": [],
        "branches": [
            "master",
            "branch-2025.1",
            "branch-2025.2"
        ],
        "latest": "branch-2025.2",
        "unstable": ["master"],
        "deprecated": []
    }
   

4. Submit your changes in a pull request and get it approved.

5. Once merged, the new version will be published.

   Note

   For open-source and enterprise projects, publication will trigger automatically the next time the associated repository receives an update. This is because scylladb-docs-homepage only defines the versions, not the publication scripts.

Trigger a manual publication¶

If you need to publish a new version immediately on the projects:

• ScyllaDB Homepage

• ScyllaDB Manual

You can trigger a manual publication by following these steps:

1. Go to the Actions tab in the scylladb-docs-homepage repository.

2. Find the workflow you want to run: Docs / Publish docs.scylladb.com or Docs / Publish docs.scylladb.com/manual.

3. Click on the workflow name to open the workflow details.

4. Click the Run workflow button.

5. In the Branch field, keep main.

6. Click the green Run workflow button.

For more details, see Manually running a workflow.