Repository navigation
π Dashboard UI map, docs-site help links and a Settings entry per tab - #19201
Conversation
β¦s entry per tab Add src/docs/dashboard-ui-map.md with sign-in steps for each kind of dashboard, common actions, and sidebar and Settings tables generated from the dashboard source by src/scripts/render-dashboard-ui-map.py (checked in the docs link workflow). Point v5 help links at docs.hivecommons.dev for pages the docs site publishes. Add the missing Settings tab entries and record the Kapa-side checklist status in the Ask AI design. Refs #19182 Signed-off-by: Andy Anderson <andy@clubanderson.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
Docs map: this PR adds page(s) under
A page missing from the map is one readers do not find. Please add a If the page is indexed from a subdirectory README, or is deliberately |
Open PR overlap checkBase branch: Conflicts are checked with every PR merged onto the current tip of
|
UI render evidenceRender evidence captured. Built from
These are fixture renders, not live data: the page was built from the PR head and filled with synthetic data from |
|
Overlap note: #19192 (opened earlier for the same issue) also adds |
|
Hive status β updated in place; edits do not notify. Full history is in the Activity Monitor. @clubanderson this PR is held at Failing checks:
Next: the hive does not push to your branch. Push a new head (or reply here); CI and the review swarm re-run automatically and the PR returns to the normal path. βΉοΈ Sentinel: informational, author is trusted (owner), merge is not blocked. Head
No merged by Hive trusted-author auto-merge: author |
src/scripts is pinned by TRUSTED_SCRIPTS_TREE for the integration governance verifier; a docs generator does not belong in that closure. Refs #19182 Signed-off-by: Andy Anderson <andy@clubanderson.com>
Docs coverage for the dashboard Ask AI help (phase 3 of the design in
src/docs/design/dashboard-ask-ai-help.md).What changes
src/docs/dashboard-ui-map.md. How to sign in to the hosted hub, a hosted hive dashboard and a self-hosted dashboard (the area Kapa answered poorly), a table of common actions ("add a repository", "pause an agent", "open Settings"), and generated tables of the sidebar entries, the Settings tabs and the per-agent tabs with their on-screen labels.src/pkg/dashboard/uimap/render-dashboard-ui-map.py(kept out ofsrc/scripts, whose tree is pinned for the governance verifier). Readsstatic-src/html/sidebar.html,DASHBOARD_SECTION_HELPinsections.jsand the tab lists inconfig-state.js, and rewrites only the text between the markers.--checkruns in the docs link workflow, so a renamed section or tab fails CI until the page is regenerated.dashboardDocsHrefopenshttps://docs.hivecommons.dev/docs/hive/<page>on the v5 line for pages the docs site publishes today (each checked for HTTP 200 and matching heading anchors), and keeps GitHub for the rest and for other release lines, since the site follows v5 only. Same edit instatic-src/js/sections.jsand the committedstatic/index.html. Newdashboard_docs_href.test.jscovers the four cases.settings.mdgets an entry for every Settings tab that had none (Appearance, Agents, Workflows, Inbox, Project Observability, Meetings, Forge App, Bob, Variables), and bothsettings.mdanddashboard-sections.mdlink the UI map.Companion change
The docs site PR in hivecommons/docs publishes
dashboard.md,settings.md,hosted-hub.md,hub-deployment.mdandtelemetry.md(all were on its deliberate-omission list) and marks design records so the vendor can exclude them. After this PR merges, the docs site's scheduled refresh picks updashboard-ui-map.mdbecause synced pages link to it; once those pages are live they can be added to the docs-site list indashboardDocsHref.Checks
check-docs-links.py src/docsandcheck-docs-citations.py src/docspass locally;render-dashboard-ui-map.py --checkis up to date. No local build or tests were run.What remains on #19182
The Ask-specific telemetry and consent wording waits for phases 1 and 2, and two vendor-side source exclusions (ADR URL prefix, design-record selector) are for the project owner.
Refs #19182