Repository navigation
fix(docs): restore legacy documentation URLs - #775
Conversation
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars.
 |
Aleksei Sviridkin (lexfrei)
left a comment
Aleksei Sviridkin (lexfrei)
left a comment
There was a problem hiding this comment.
myasnikovdaniil LGTM.
I built the whole stack on a trial merge with current main, with Hugo 0.164.0 in production mode. Main is on v1.7 now, so the rollover path ran for real. I served the output with a plain static server and requested each URL with ?utm=x#frag appended. All six legacy URLs and the four /docs/v1/ forms return 200 with no redirect and no meta refresh. Canonical and robots match the target page, distro-hosted stays noindex without a canonical, and none of the copies end up in the sitemaps. Numbered archives (/docs/v1.0/, /docs/v1.6/applications/mariadb/, the v0 bundles page) are still served.
Non-blocking: /roadmap/ is special-cased twice in mirror_latest.py, in the destination check and in the manifest check. The next non-docs legacy URL will need a third place, so a list in one spot would be easier. Fine to leave until then.
Map missing applications, MySQL, kexec, LINSTOR and roadmap URLs to their current content. Keep distro-hosted on the v0 bundles archive. The LINSTOR mapping uses the storage overview because its historical page was not found. Serve static HTML copies with the target's canonical and robots policy, including the current-major paths. Preserve queries and existing fragments without redirects or JavaScript. Validate all mappings before output is replaced and include compatibility pages in ownership-based cleanup. Cover HTTP responses, release rollover, preview policy, archived content, invalid mappings, symlinks and collisions with real pages. Assisted-By: LLM Signed-off-by: Myasnikov Daniil <[email protected]>
4974b0b to
40e64f6
Compare
✅ Deploy Preview for cozystack ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This restores six legacy URLs as static HTML pages.
Follow-up to PR 772, part of the website epic.
/docs/reference/applications//docs/applications//docs/reference/applications/mysql//docs/applications/mariadb//docs/install/talos/kexec//docs/install/talos/boot-to-talos//roadmap//docs/roadmap//docs/bundles/distro-hosted//docs/v0/operations/configuration/bundles//docs/operations/storage/linstor//docs/storage/The current-doc mappings also serve their four
/docs/v1/forms. All copies return HTTP 200 without JavaScript, query strings and existing fragments stay on the requested URL. Current content uses the target canonical.distro-hostedstays on archived, noindex content. LINSTOR uses the storage overview because its exact historical page could not be confirmed.Mappings are checked before output is replaced, including missing targets, symlinks and collisions with real pages. Compatibility copies use the existing ownership manifest and are cleaned on rollover.
Checked with Hugo extended 0.164.0: production and preview builds, full-site canonical/robots/sitemap checks, 24 routing fixtures, 129 translation tests, version-pin tests and i18n lint. Anchor corrections remain in PR 745.