Skip to content

ci: add docs sync workflow to keeperhub#17

Merged
eskp merged 1 commit intomainfrom
docs/add-sync-workflow
Mar 15, 2026
Merged

ci: add docs sync workflow to keeperhub#17
eskp merged 1 commit intomainfrom
docs/add-sync-workflow

Conversation

@eskp
Copy link
Copy Markdown
Contributor

@eskp eskp commented Mar 15, 2026

Summary

  • Add GitHub Actions workflow that syncs CLI command reference to the keeperhub docs-site
  • Triggers on release publish or manual dispatch
  • Regenerates docs from Go source, copies to keeperhub docs/cli/, creates a PR

How it works

  1. Checks out both cli and keeperhub repos
  2. Runs go generate ./docs/... to regenerate cobra markdown
  3. Copies kh*.md to keeperhub/docs/cli/commands/
  4. Adds Nextra frontmatter to quickstart.md and concepts.md
  5. Regenerates commands/_meta.ts from filenames
  6. Fixes internal links for Nextra routing
  7. Creates a PR in keeperhub targeting staging

Setup required

  • Add KEEPERHUB_PAT secret: a token with contents:write and pull-requests:write on techops-services/keeperhub

Test plan

  • Add KEEPERHUB_PAT secret to repo settings
  • Trigger workflow manually to verify end-to-end

On release or manual trigger, regenerates CLI command docs and syncs
them to the keeperhub docs-site via cross-repo PR. Keeps CLI reference
pages in sync without manual maintenance.
@eskp eskp merged commit 837cb3a into main Mar 15, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant