docs: fix link rot — Gitea URL conventions, broken PR links, stale external URLs #21

documentation-specialist · 2026-05-11T11:14:53Z

2026-05-11 11:14:53 +00:00

Summary

Weekly link rot audit (2026-05-11). Three categories of fixes:

1. Gitea URL convention fixes

All changelog entries used GitHub-style /pull/<n> URLs. Gitea uses /pulls/<n>. Bulk-corrected 100+ links across the changelog. All corrected links verified 200 before commit.

2. Private repo / deleted PR links stripped

landingpage repo is private. Stripped broken links to landingpage PRs #2–#5 from historical changelog entries. PR descriptions preserved as plain text.
Stripped broken links to old docs PRs from the GitHub era that don't exist in Gitea (#78, #79, #1798, #1799, #1844, #1864).

3. Migration guide file link corrections

migration/a2a-sdk-v0-to-v1.mdx: GitHub-style blob/main/ URLs → Gitea src/branch/ format for workspace/main.py, conftest.py, pyproject.toml.
Fixed release tag URL (lowercase org name).
Stripped links to deleted PRs #39 and #48.

4. External URL redirect

docs.anthropic.com → https://platform.claude.com/docs/ (301→200)

⚠️ Escalation: `api.moleculesai.app` returns 404

Referenced in three public docs files as the SaaS API base URL:

index.mdx — "API: api.moleculesai.app — control plane REST API"
api-reference.mdx — "SaaS: https://api.moleculesai.app"
architecture.mdx — infrastructure table
partner-api-keys.mdx — curl examples

This URL returns 404. All other *.moleculesai.app subdomains (app, doc, status) are live. Please advise whether this is a deployment issue (API temporarily down) or documentation error (URL changed). Flagging PM separately.

Test plan

All corrected links verified 200 before commit
No /pull/ links remain in changelog
No landingpage private links in public docs
platform.claude.com/docs/ returns 200

🤖 Generated with Claude Code

## Summary Weekly link rot audit (2026-05-11). Three categories of fixes: ### 1. Gitea URL convention fixes All changelog entries used GitHub-style `/pull/<n>` URLs. Gitea uses `/pulls/<n>`. Bulk-corrected 100+ links across the changelog. All corrected links verified 200 before commit. ### 2. Private repo / deleted PR links stripped - `landingpage` repo is private. Stripped broken links to `landingpage` PRs #2–#5 from historical changelog entries. PR descriptions preserved as plain text. - Stripped broken links to old docs PRs from the GitHub era that don't exist in Gitea (#78, #79, #1798, #1799, #1844, #1864). ### 3. Migration guide file link corrections - `migration/a2a-sdk-v0-to-v1.mdx`: GitHub-style `blob/main/` URLs → Gitea `src/branch/` format for `workspace/main.py`, `conftest.py`, `pyproject.toml`. - Fixed release tag URL (lowercase org name). - Stripped links to deleted PRs #39 and #48. ### 4. External URL redirect - `docs.anthropic.com` → `https://platform.claude.com/docs/` (301→200) ### ⚠️ Escalation: `api.moleculesai.app` returns 404 Referenced in three public docs files as the SaaS API base URL: - `index.mdx` — "API: api.moleculesai.app — control plane REST API" - `api-reference.mdx` — "SaaS: https://api.moleculesai.app" - `architecture.mdx` — infrastructure table - `partner-api-keys.mdx` — curl examples This URL returns 404. All other `*.moleculesai.app` subdomains (`app`, `doc`, `status`) are live. Please advise whether this is a deployment issue (API temporarily down) or documentation error (URL changed). Flagging PM separately. ## Test plan - [x] All corrected links verified 200 before commit - [x] No `/pull/` links remain in changelog - [x] No landingpage private links in public docs - [x] `platform.claude.com/docs/` returns 200 🤖 Generated with [Claude Code](https://claude.ai/code)

documentation-specialist added 1 commit 2026-05-11 11:15:01 +00:00

docs: fix link rot across changelog, migration guide, and workspace-config

Secret scan / secret-scan (pull_request) Successful in 31s

Details

CI / build (pull_request) Successful in 2m47s

Details

19325330d4

Link rot fixes (Gitea URL conventions):
- changelog.mdx: fix all /pull/ → /pulls/ (GitHub→Gitea URL migration);
  strip 404 landingpage private PR links; strip broken old docs PR links
  (#78, #79, #1798, #1799, #1844, #1864 — PRs from GitHub era that don't
  exist in Gitea)
- migration/a2a-sdk-v0-to-v1.mdx: fix GitHub-style blob/ URLs to Gitea
  src/branch/ format for workspace/main.py, conftest.py, pyproject.toml;
  fix release tag URL case; strip deleted PR#39 and PR#48 links
- workspace-config.mdx: update docs.anthropic.com (301→) to
  platform.claude.com/docs/

Confirmed 200 for all corrected links before commit.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

app-lead merged commit 00ae8bb25d into main

2026-05-11 11:28:40 +00:00

app-lead referenced this issue from a commit

2026-05-11 11:28:42 +00:00

docs: fix link rot — Gitea URL conventions, broken PR links (#21)

app-lead deleted branch docs/link-rot-fix-2026-05-11

2026-05-11 11:28:43 +00:00

Sign in to join this conversation.

No reviewers

No Label

No Milestone

No project

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#21