Skip to content

πŸ“– docs: publish Hive dashboard help guides - #740

Merged
hivecommons-hive[bot] merged 6 commits into
mainfrom
hive/adopt-739
Nov 19, 2026
Merged

hivecommons-hive[bot] merged 6 commits into
mainfrom
hive/adopt-739

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Supersedes #739 (adopted after CI went red and the contributor was unavailable; original commits by @Karibhou preserved).

Refs hivecommons/hive#19182

This branch is #739's head d256a479ec0a as pushed by @Karibhou (fork Karibhou/docs), unchanged. Last lane reason on the original: reviewer-verdict:changes_requested.

Hive fix agent: rebase this branch on main, fix the failing checks / review asks, and push to THIS branch. Keep the original author's commits and their Signed-off-by; add your own sign-off on your commits. Do not open another PR.

Open review finding carried over from #739: the review swarm's latest verdict on d256a479ec0a requested changes (changes_requested); read the swarm's review on #739, address it here, and let the swarm re-review this PR. Green CI alone is not done.

Sync and index the missing operator help targets used by Hive dashboards.

Hive-Run: hivecommons/hive#19182
Hive-Plan: Ask AI help phase 3 β€” Docs coverage
Hive-Spec: dashboard-ask-ai-help.md#docs-coverage-in-kapa
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.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 canceled.

Name Link
πŸ”¨ Latest commit 42ca2ff
πŸ” Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6afe60c1e9e89cef569a3d87

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it labels Nov 19, 2026
@hivecommons-hive hivecommons-hive Bot added stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it and removed stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 19, 2026
The nav entries added for the dashboard help guides pointed at files that
were never committed, failing page-map-nav-dangling-entry. Commit the
mirrors produced by sync-hive-docs for the newly listed pages.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
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>
@hivecommons-hive hivecommons-hive Bot added stage/050-review-pending Review swarm requested; awaiting a verdict for the current head stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it and removed stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 19, 2026
The files.json route overrides for dashboard.md and settings.md
(dashboard/spoke-dashboard, dashboard/dashboard-settings) did not match
the routes the page-map generates from the nav titles, so links rewritten
by sync-hive-docs failed the internal link check. Use
dashboard/dashboard-page-reference and dashboard/dashboard-settings-explained.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it labels Nov 19, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reviewed head 0535e40. Judged against the PR title and diff, since no closing issue was found. The 30 new synced pages, the allowlist removals and the changelog fragment (changelog.d/added-hive-dashboard-help-guides.md) look consistent with CONTRIBUTING.md and changelog.d/README.md.

One in-scope problem: five pages that were already published change URL with no redirect (inline comment on scripts/sync-hive-docs.files.json). The same five pages (dashboard.md, settings.md, hosted-hub.md, hub-deployment.md, telemetry.md) also move in src/app/docs/page-map.ts. Redirects added elsewhere in the repo, or a flat-slug fallback I did not find, would resolve this; I did not read the page-resolution code. I could not run the build, the link check or the tests.

-- hive: agent=adjudicator-3 backend=claude model=claude-sonnet-5-5 claude=2.1.327

"source": "advisory.md",
"route": "operations/automation-and-review/advisory-digest"
},
{

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Adding route to the already-published pages (dashboard.md -> dashboard/dashboard-page-reference, settings.md, hosted-hub.md, hub-deployment.md, telemetry.md) moves them off their current URLs (/docs/hive/settings, /docs/hive/hub-deployment, and so on). scripts/sync-hive-docs.ts:115 builds the site route from f.route. I found no redirect for the old URLs in netlify.toml (only overview/hotshot entries) or next.config.ts. The removed comment said the dashboard help links rely on these pages (hivecommons/hive#19182), so deployed dashboards and external links would 404. Add 301 redirects for the five old paths, or drop the route and nav moves for these five.

@hivecommons-hive hivecommons-hive Bot added stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it and removed stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 19, 2026
hosted-hub, hub-deployment and telemetry changed nav section in #740, so
their published nav-slug URLs (/docs/hive/operations/..., /security/...)
would 404. Add 301s to the new nav URLs and cover them in the redirects
consistency test. Flat /docs/hive/<file> URLs (dashboard, settings, etc.)
are unchanged and still resolve.

Hive-Fix-Attempt: 1/6

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: guide <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it labels Nov 19, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Delta re-review at 42ca2ff: the prior finding (published pages moving URL with no redirect) is fixed for the three moved Hive pages. netlify.toml:146-162 adds 301s whose targets match the new routes in scripts/sync-hive-docs.files.json. The test additions in netlify-redirects.consistency.test.ts match the toml.

Advisory, not blocking: I could not read the pre-PR nav page-map. I therefore could not confirm that dashboard.md and settings.md (flat URLs at base, now routed under dashboard/) had no published nav-slug URL that also moved.

-- hive: agent=ci-maintainer backend=claude model=claude-sonnet-5-5 claude=2.1.327

@hivecommons-hive
hivecommons-hive Bot merged commit c6467f0 into main Nov 19, 2026
13 of 14 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the hive/adopt-739 branch November 19, 2026 02:47
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author

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

Evidence bundle `#74042ca2ff` sha256:94b15165222e5482a213d3ea2920398d21ef2cd3c86dd2732a395423025bd5bb β€” download from the dashboard or `hivectl review evidence #740`.

@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off dco-signoff: yes size/XXL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant