Skip to content

docs: fix the self-healing links, the redirects and the duplicated tree - #102

Merged
SebConejo merged 3 commits into
mainfrom
fix/self-healing-url
Sep 21, 2026
Merged

SebConejo merged 3 commits into
mainfrom
fix/self-healing-url

Conversation

@SebConejo

@SebConejo SebConejo commented Sep 21, 2026 •

Copy link
Copy Markdown
Member

Why

The self-healing docs moved to docs.manifest.build. The menu and the header button still pointed at manifest.build/docs, which now redirects back to this site.

Mintlify serves this site under the /llm-gateway/docs subdirectory and adds that prefix to every path it emits. #97 wrote the prefix into the repo as well, so it was applied twice. Two consequences, both live:

  • Every redirect returned 404. /llm-gateway/docs/install sent readers to /llm-gateway/docs/llm-gateway/docs/self-hosted.
  • The 47 pages copied under llm-gateway/docs/ were never served. Their only possible address was /llm-gateway/docs/llm-gateway/docs/<page>, which must never exist.

What changed

  • The logo menu and the header button open https://docs.manifest.build.
  • The duplicated page tree is deleted. The repo carries one copy of each page again.
  • The subdirectory is gone from the navigation and from all 622 internal links. The repo no longer knows where the site is mounted, which is Mintlify's job.
  • Redirect destinations are relative again, and the duplicated sources are gone. 17 redirects remain.
  • The errors link on the self-hosted page shows the real public address, and a typo on that line is fixed.
  • The issue template quotes the new address shape.

Public addresses stay manifest.build/llm-gateway/docs/<page>.

Check

Crawled locally: the 30 navigation pages return 200, the 17 redirects land on a 200, and no internal link is broken. node scripts/check-coherence.mjs is GREEN.

…the redirects

Mintlify serves this site under the /llm-gateway/docs subdirectory and adds
that prefix to every redirect destination, so the prefixed destinations
resolved twice and returned 404. Destinations are relative again, and the
duplicated prefixed sources are gone.
…directory

Mintlify serves this site under /llm-gateway/docs and adds that prefix to
every path, so the repo must not carry it. The 47 copies under
llm-gateway/docs/ were never served, and the prefix is gone from the
navigation and from every internal link.
@SebConejo SebConejo changed the title docs: fix the self-healing links and the broken redirects docs: fix the self-healing links, the redirects and the duplicated tree Sep 21, 2026
…orm repo

.mintignore now covers CLAUDE.md, references/ and scripts/, so the files
the agents read never become public pages. The agent instructions point at
mnfst/llm-gateway, the platform repo's current name.
@SebConejo
SebConejo merged commit 3797f6f into main Sep 21, 2026
1 check passed
@guillaumegay13
guillaumegay13 deleted the fix/self-healing-url branch September 26, 2026 21:33
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