wu-sheng opened a new pull request, #38: URL: https://github.com/apache/skywalking-horizon-ui/pull/38
## What A documentation accuracy + structure pass after the 0.6.0 release, plus a small release-tooling cleanup. ## Docs — staleness fixes (audit-found, adversarially re-verified against current code) - **RBAC** (`access-control/rbac.md`, `setup/rbac.md`): document `infra-3d:read`; built-in roles carry it via the baseline. - **`access-control/admin-pages.md`**: add `/admin/3d-map` (`overview:write`). - **`access-control/audit-log.md`**: rewrite the recorded-actions table to the actually-emitted actions (`addOrUpdate`/`inactivate`/`delete` with `details.catalog`, `alarms.config.save`, `setup.save`, `debug.start/stop`); drop the never-emitted `*-template.write`/`setup.write` rows; fix the failure outcome format (`http_<code>`). - **`operate/inspect.md`**: correct the BFF routes to `/api/inspect/*`. - **`design-target.md`**: add the Topology overview widget. - **`customization/layer-templates.md`**: fix the components example to the real flag keys; add the `dependency` dashboard scope. - **`operate/infra-3d-map.md`**: rewrite Configuration for the redesigned model (single metric; one global filter + explicit tier pins + failover tier; logic groups; local draft → Check diff & push); add the Hierarchy pipeline stage. ## Docs — structure & principles - **Config docs are concept-first.** `infra-3d-map` / `layer-templates` / `overview-templates` lead with the concept + the admin UI; the JSON shape is a reference appendix. These admin pages are structured editors, not raw-JSON editors, so the docs no longer imply one. - **No hardcoded Horizon version.** The website pins docs per release, so `overview.md` and `audit-log.md` are version-neutral; `container-image.md` stays as the release-tooling-maintained exception. - **i18n.** `i18n.md` gains a language × scope coverage matrix; `adding-a-new-layer.md` gains the "Add translations (i18n)" step and is rounded out as the contributor recipe. - **`docs/CLAUDE.md`** (new) records the doc-writing principles: operator-perspective-first, config-UI-first with JSON-as-appendix, no hardcoded versions, and a carve-out for contributor pages. ## Release tooling - **`scripts/release-finalize.sh`**: the container image is published to Docker Hub by CI on every `v*` tag, so the finalize Step 5 now only **verifies** the published tags — the manual local-push fallback and the Docker Hub login preflight were removed. ## Changelog Recorded under **0.7.0**. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
