Skip to content

docs: the docs repo is docs-mantis, not mantis-docs - #80

Merged
AdamXweb merged 4 commits into
mainfrom
docs/readme-docs-site
Aug 10, 2026
Merged

docs: the docs repo is docs-mantis, not mantis-docs#80
AdamXweb merged 4 commits into
mainfrom
docs/readme-docs-site

Conversation

@adamXbot

@adamXbot adamXbot commented Aug 9, 2026

Copy link
Copy Markdown
Collaborator

Found while checking every repo's README against this session's changes.

Every documentation link in this repo — 17 across 9 files — points at github.com/privacykey/mantis-docs. That repo was renamed to docs-mantis. The links still work, but only because GitHub redirects renamed repositories, and that redirect stops the moment anyone creates a new repo under the old name.

Four of these ship to users, not just to readers of the README:

File What the user sees
src/app/(app)/layout.tsx The dashboard's Docs link
src/app/login/page.tsx Link on the login screen
src/app/(app)/keys/[id]/download-formats.tsx The file-key download panel
cli/src/commands/init.ts Printed by mantis init

The rest are the README, cli/README.md, and three deploy templates.

I verified all ten distinct pages these link to exist in docs-mantis at mainapi.md, getting-started.md, use-cases.md, file-keys.md, host-events.md, self-hosted-apps.md, updating.md, deployment/README.md, deployment/cloudflare.md, deployment/edge-limits.md.

What I deliberately did not do

I did not repoint these at docs.mantis.privacykey.org.

That is where they should eventually go, and the marketing site already uses it. But the hostname has no DNS yet, and mantis is shipping (cli-v0.1.6 is on the Homebrew tap). Moving live product links onto a dead domain would trade working links for broken ones. Worth a one-line follow-up once the docs site is actually published — happy to prepare it now so it's ready to merge the day DNS lands.

Adam and others added 4 commits August 10, 2026 00:11
Every documentation link in this repo — 17 across 9 files — pointed at
github.com/privacykey/mantis-docs. That repo was renamed to docs-mantis, so
the links only still work because GitHub redirects renames. That redirect is
not a guarantee: it breaks the moment anyone creates a new repo under the old
name.

Four of these ship to users rather than sitting in a README:

  src/app/(app)/layout.tsx              the dashboard's Docs link
  src/app/login/page.tsx                the login screen
  src/app/(app)/keys/[id]/…             the file-key download panel
  cli/src/commands/init.ts              printed by `mantis init`

Verified all ten linked pages exist in docs-mantis at main.

Deliberately NOT switched to docs.mantis.privacykey.org. That is where these
should eventually point, but the hostname has no DNS yet — moving shipping
product links onto a dead domain would replace working links with broken ones.
Worth a follow-up once the docs site is published.
The href rename left the link text naming the old repo, so the
dashboard download panel and the CLI README displayed "mantis-docs"
while pointing at docs-mantis.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Move all 17 documentation links off the GitHub Markdown source and onto
the Mintlify site, mapping each path to its rendered slug (drop the .md,
and deployment/README.md -> /deployment, which is the nav root).

Also refresh the prose and link labels that described the old target: the
README no longer says the site isn't live, and two link labels that read
as repo filenames now read as docs pages.

Note: docs.mantis.privacykey.org does not resolve yet (NXDOMAIN). These
links will fail until DNS is pointed at the Mintlify deployment, which
includes the dashboard Docs link, the login page, the file-key download
panel, and `mantis init` output.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@AdamXweb
AdamXweb merged commit ee08d72 into main Aug 10, 2026
8 checks passed
@AdamXweb
AdamXweb deleted the docs/readme-docs-site branch August 10, 2026 16:40
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.

2 participants