Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

Redirect legacy docs.flox.dev to flox.dev/docs#489

Closed
Kaysahni wants to merge 1 commit into
mainfrom
fix/redirect-legacy-docs-to-mintlify
Closed

Redirect legacy docs.flox.dev to flox.dev/docs#489
Kaysahni wants to merge 1 commit into
mainfrom
fix/redirect-legacy-docs-to-mintlify

Conversation

@Kaysahni
Copy link
Copy Markdown
Contributor

Problem

docs.flox.dev still serves the old MkDocs docs (this site, floxdocs.netlify.app). The new Mintlify docs live at flox.dev/docs. Per Tanja, we want a 301 so the legacy subdomain forwards to the new home.

Change

Replaces the single /* → /docs/ (302) rule with permanent (301) redirects to flox.dev/docs:

  • Path-preserving: /docs/* → https://flox.dev/docs/:splat. I tested all 99 URLs from the old sitemap against the new site — 93 resolve 1:1 (the new site's legacy redirect rules + Mintlify handle them).
  • Explicit mappings for 2 pages reorganized in the migration:
    • /docs/man/flox-build-update-catalogs/docs/man/flox-build
    • /docs/man/nix-builds.toml/docs/man/manifest.toml
  • Fallback: everything else → https://flox.dev/docs.

The remaining 4 of the 99 are former MkDocs include//snippets/ partials that were never real pages, so no user-facing 404s.

Verify after deploy

  • curl -I https://docs.flox.dev/ → 301 → https://flox.dev/docs
  • curl -I https://docs.flox.dev/docs/install-flox/install/ → 301 → https://flox.dev/docs/install-flox/install (200)
  • curl -I https://docs.flox.dev/docs/man/flox-build-update-catalogs/ → 301 → /docs/man/flox-build

Note: the flox/floxfloxdocs release sync only touches doc content, not netlify.toml, so this redirect should persist until FLO-53 retires this site.

The new Mintlify docs live at flox.dev/docs. Point this legacy MkDocs
site there with permanent (301) redirects instead of serving stale
content.

- Path-preserving /docs/* -> flox.dev/docs/:splat (93/99 legacy URLs
  resolve 1:1 on the new site).
- Explicit mappings for two pages renamed/removed in the migration:
  flox-build-update-catalogs -> flox-build, nix-builds.toml ->
  manifest.toml.
- Everything else -> the docs home.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 22, 2026
@devusb
Copy link
Copy Markdown
Contributor

devusb commented May 26, 2026

@devusb devusb closed this May 26, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants