Documentation Publishing Workflow for the devops repository

Last Updated: January 2026

Overview

This document describes how documentation from the devops repository is automatically published to the Open Horizon website.

Source Locations

• docs/ folder → Published to: https://open-horizon.github.io/docs/mgmt-hub/docs/

Automation Process

The documentation publishing workflow follows these steps:

1. Changes are pushed to the master branch in the devops repository
2. GitHub Actions trigger automatically:
   • copydocs.yml - Copies docs folder content
3. Files are copied to the open-horizon.github.io repository
4. A rebuild is triggered in the open-horizon.github.io repository
5. Updated documentation is published to the website

GitHub Actions

The following GitHub Actions automate the documentation publishing process:

• copydocs.yml

Troubleshooting

If documentation updates don’t appear on the website:

• Check GitHub Actions status in both repositories (devops and open-horizon.github.io)
• Verify changes were merged to the master branch
• Allow 5-10 minutes for the full publishing pipeline to complete
• Review the GitHub Actions logs for any error messages