Skip to content

πŸ“– docs: Using Spektacular with Hive operator guide - #45

Merged
clubanderson merged 1 commit into
mainfrom
docs/spektacular-with-hive
Sep 24, 2026
Merged

clubanderson merged 1 commit into
mainfrom
docs/spektacular-with-hive

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Adds docs/content/hive/spektacular-runs.md β€” an operator guide for running Spektacular spec β†’ plan β†’ implement runs under Hive v6 β€” and links it under Operations in the nav.

Covers:

  • Prerequisites, including two gotchas verified against hive@v6: spektacular is not in the Hive image, and the stage runner shells out from the hub process cwd with no per-repo dir.
  • runs.spektacular, runs.checkpoints, runs.triage, and governor.work_source.run_stages config.
  • Starting a run (run/spec label or triage), the stage lifecycle, retries/escalation/stale-plan handling.
  • Troubleshooting table and known gaps (plan export upstream ask, fake-CLI e2e).

Verified: npm run lint, markdownlint, check-links, npm run build all pass; page renders at /docs/hive/spektacular-runs.

Hand-written guide for Hive v6 long-running runs: prerequisites (binary not in
image, hub cwd must resolve the Spektacular project), config, starting a run
via run/spec label or triage, stage lifecycle, retries/stale plans,
troubleshooting table, and known gaps. Added under Operations in the nav.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign clubanderson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@clubanderson
clubanderson merged commit 06a667a into main Sep 24, 2026
6 of 7 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs/spektacular-with-hive branch September 24, 2026 19:12
@netlify

netlify Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

βœ… Deploy Preview for hivecommons-docs ready!

Name Link
πŸ”¨ Latest commit 36805d1
πŸ” Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6ab575b0a34e4a00088b081f
😎 Deploy Preview https://deploy-preview-45--hivecommons-docs.netlify.app
πŸ“± Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant