Skip to content

fix(catalogue): alias the playbook dependency-versions address - #61

Merged
kieronlanning merged 1 commit into
mainfrom
fix/engineering-playbook-dependency-versions-alias
Nov 8, 2026
Merged

kieronlanning merged 1 commit into
mainfrom
fix/engineering-playbook-dependency-versions-alias

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

What

engineering-playbook's wiki now includes docs/wiki/foundations/Dependency-Versions.md, which publishes under its topic folder at /docs/engineering-playbook/foundations/dependency-versions/ (ADR 0011). A reader — or a link — that looks for the page at the docs root therefore 404s.

This declares that docs-root address in docs.redirects, so the build writes a noindex meta-refresh page from /docs/engineering-playbook/dependency-versions/ to the nested page. It is only written while the nested page is published, because writeStaticRedirect never shadows a real page.

Verification

  • just validate → Validation passed: format-check, lint, typecheck (0 errors, 0 warnings, 0 hints), 351 unit tests, check-assets, check-projects (17 projects, 1 collaboration), build, discovery-validate, check-links, check-generated, 44 dist tests.
  • dist/docs/engineering-playbook/dependency-versions/index.html is the redirect:
    <meta http-equiv="refresh" content="0; url=/docs/engineering-playbook/foundations/dependency-versions/">
    with canonical https://purview.dev/docs/engineering-playbook/foundations/dependency-versions/ and robots: noindex, follow.
  • The destination page is unchanged and still renders its 11 registry badges verbatim — no raw.githubusercontent.com rewrite, so the badges keep working.
  • New regression test: the playbook keeps its docs-root dependency-versions address (351 tests, 1165 expectations).

Follow-up to #60. No other catalogue entry is touched and no release numbers are introduced.

`docs/wiki/foundations/Dependency-Versions.md` publishes under its topic
folder, so its URL is
`/docs/engineering-playbook/foundations/dependency-versions/` (ADR 0011) and
the docs-root address a reader may look for 404s. The catalogue now declares
that address in `docs.redirects`, so the build writes a noindex meta-refresh
page pointing at the nested one - and only while the nested page is published,
because a real page always owns its URL.

Verified in the built site: the flat address is a redirect, and the nested page
still renders its 11 registry badges verbatim (no `raw.githubusercontent.com`
rewrite).
@kieronlanning
kieronlanning merged commit 8cd28b8 into main Nov 8, 2026
1 check passed
@kieronlanning
kieronlanning deleted the fix/engineering-playbook-dependency-versions-alias branch November 8, 2026 13:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant