Skip to content

πŸ“– hive: publish the third-party Integration guide - #177

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/hive-integration-guide
Oct 3, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/hive-integration-guide

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Summary

Hive's third-party Integration guide (hivecommons/hive#10171) existed only in hivecommons/hive src/docs/ and was not in this site's sync allowlist, so it had no public URL.

  • scripts/sync-hive-docs.ts: add integration-guide.md, integrations/work-source-providers.md, integrations/clanker-flue.md, integrations/spektacular.md to the synced set.
  • src/app/docs/page-map.ts: new Integrating with Hive nav section (Integration guide Β· Work-source providers Β· Clanker (Flue-style) interface Β· Spektacular project inception) between Operations and Security.
  • Commit the synced pages (the generic link rewriter resolved the cross-links to /docs/hive/... routes and GitHub blob URLs for unsynced files).
  • Changelog fragment.

Validation

  • npx tsx scripts/sync-hive-docs.ts β†’ 4 new pages synced
  • vitest run β†’ 82 files / 789 tests passed
  • eslint src/ β†’ 0 errors
  • markdownlint-cli2 on the 4 new pages β†’ 0 issues

Sync src/docs/integration-guide.md and src/docs/integrations/* from
hivecommons/hive@v5 and expose them under a new "Integrating with Hive"
nav section so the work-source provider and Clanker interface endpoints
are discoverable on docs.hivecommons.dev.

Refs hivecommons/hive#10171

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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

@netlify

netlify Bot commented Oct 3, 2026 •

Copy link
Copy Markdown

βœ… Deploy Preview for hivecommons-docs ready!

Name Link
πŸ”¨ Latest commit 937b435
πŸ” Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6ac0db23b8fd61000851192c
😎 Deploy Preview https://deploy-preview-177--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.

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verified against the tree rather than the description:

  • All four sources exist in hivecommons/hive@v5 under src/docs/ (integration-guide.md, integrations/{work-source-providers,clanker-flue,spektacular}.md), so the new scripts/sync-hive-docs.ts allowlist entries resolve at build time instead of 404ing against raw.githubusercontent.
  • The committed pages carry the canonicalHeader() banner the script emits, and the cross-links are rewritten the way the script's two cases describe: synced docs β†’ /docs/hive/... routes, unsynced ones (runs.md, work-source-terminology.md, api-reference.md) β†’ blob/v5 GitHub URLs. Consistent with the existing adr/ subdirectory handling.
  • src/app/docs/page-map.ts nav entries point at the same four target paths the sync writes.
  • Build, internal-link check, lint, and unit tests are green on 937b435.

Body matches the diff. Looks correct to me.

β€” hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit 2474d8d into main Oct 3, 2026
11 of 12 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs/hive-integration-guide branch October 3, 2026 11:12
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