Skip to content

πŸ“– Publish the Hive dashboard, settings, hub and telemetry pages and mark design records - #741

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/ask-help-ui-pages
Nov 19, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/ask-help-ui-pages

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Docs-site side of the dashboard Ask AI help docs coverage.

What changes

  • Pages published. dashboard.md (Dashboard page reference), settings.md (Dashboard settings explained), hosted-hub.md (Hosted Hive Hub onboarding), hub-deployment.md (Self-hosted hub deployment) and telemetry.md (Data collection and telemetry) move from the deliberate-omission list into the sync list and the Hive nav. The dashboard's help links, hosted onboarding and sign-in questions rely on them, and the site's Ask AI could not cite them. Synced content is committed for the new pages and for the pages whose links now resolve to them; unrelated upstream drift is left to the scheduled refresh.
  • Design records kept out of AI ingestion. Hive pages under design/ and adr/ render a hidden <div data-docs-kind="design-record"> (helper in src/lib/designRecord.ts, unit test added). ADRs share a URL prefix, but synced design records sit in the Reference section next to operator pages, so a URL rule cannot separate them; the Kapa website source supports "Exclude selectors", so it can skip pages containing [data-docs-kind="design-record"]. People still see and link to these pages. The four design records not yet synced are added to the omission list so the scheduled refresh does not pull them in.
  • CNCF Sandbox date. The community page said the TOC voted in October 2026. The TOC vote in [Sandbox] Hive CommonsΒ cncf/sandbox#516 opened 2026-09-22 and closed as passed on 2026-09-28 (git-vote result comment), and the CNCF project page (https://www.cncf.io/projects/hive-commons/, landscape accepted_at 2026-09-29) lists it as accepted on 2026-09-29. October 2026 was when the contribution agreement was signed and the issue closed. The page now says September 2026 and cites both.

Follow-ups

Checks

scripts/check-internal-links.ts passes locally (791 links, 321 routes). No local build, lint or tests were run.

Refs hivecommons/hive#19182

… design records

Sync dashboard.md, settings.md, hosted-hub.md, hub-deployment.md and
telemetry.md from hivecommons/hive and add them to the Hive nav, so the
dashboard help links and Ask AI answers have them. Mark Hive design records
and ADRs with a hidden data-docs-kind="design-record" element the Kapa
source can exclude by selector, and list the unsynced design records as
deliberate omissions. Correct the CNCF Sandbox acceptance date to
September 2026 per cncf/sandbox#516 and the CNCF project page.

Refs hivecommons/hive#19182

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 Nov 19, 2026 •

Copy link
Copy Markdown

βœ… Deploy Preview for hivecommons-docs ready!

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

@clubanderson

Copy link
Copy Markdown
Member Author

Overlap note: #740 (adopted from #739) also publishes dashboard.md, settings.md, hosted-hub.md, hub-deployment.md and telemetry.md, plus about 30 more pages, and edits the same sync list, omission list and page map, so the two will conflict there. Parts of this PR that #740 does not cover: the hidden design-record marker for Kapa exclusion (src/lib/designRecord.ts and its test), the omission-list entries that keep unsynced design records off the site, and the CNCF Sandbox date correction. If #740 lands first, this PR can be rebased down to those parts.

@hivecommons-hive
hivecommons-hive Bot merged commit 6c28b2b into main Nov 19, 2026
13 of 14 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs/ask-help-ui-pages branch November 19, 2026 01:50
@hivecommons-hive

hivecommons-hive Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Hive status β€” updated in place; edits do not notify. Full history is in the Activity Monitor.

Evidence bundle `#741b05d3aa` sha256:dbb62c4ef1214527a40a714973e13231867c424f9efd19234fa7baf6518a9e0a β€” download from the dashboard or `hivectl review evidence #741`.

merged by Hive trusted-author auto-merge: author clubanderson holds role owner and GitHub permission admin on repo; CI green at b05d3aa.

hivecommons-hive Bot added a commit that referenced this pull request Nov 19, 2026
Resolve overlap with #741: keep main's dashboard, settings and hosted-hub pages, and dedupe nav entries.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
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