fix(docs): rewrite 270 broken internal markdown links after subfolder restructure

The FASE 3 /docs restructure moved files into 8 subfolders (architecture,
guides, reference, frameworks, routing, security, compression, ops) but left
several link categories with stale relative paths. The new check:doc-links
gate (FASE 8) surfaced these and produced this exhaustive fix sweep.

Categories repaired (counts before → after, total broken: 270 → 0):

  i18n-relative (241 → 0): docs in subfolders now reference translations
    under docs/i18n/<locale>/docs/<subfolder>/<FILE>.md (one extra "../"
    plus the docs/<subfolder>/ segment). Affects ARCHITECTURE, FEATURES,
    USER_GUIDE, TROUBLESHOOTING, UNINSTALL, VM_DEPLOYMENT_GUIDE,
    API_REFERENCE, and the I18N.md self-reference table.

  parent-relative (14 → 0): refs like ../CLAUDE.md, ../CONTRIBUTING.md,
    ../AGENTS.md, ../Tuto_Qdrant.md, ../open-sse/..., ../electron/...,
    ../src/... promoted from one to two parent hops (../ → ../../) to
    reach repo root from docs/<subfolder>/.

  screenshots (9 → 0): FEATURES.md PNG refs rewritten to ../screenshots/
    (assets live at docs/screenshots/ unchanged).

  missing-rfc (2 → 0): RFC-AUTO-ASSESSMENT.md was deleted earlier in the
    overhaul; replaced refs in EVALS.md with pointers to the live
    AUTO-COMBO.md scoring doc plus an in-prose mention of
    src/domain/assessment/.

  other (4 → 0): ENVIRONMENT.md → ../../.env.example,
    SETUP_GUIDE.md → ../../{open-sse/mcp-server,src/lib/a2a}/README.md,
    PROVIDER_REFERENCE.md → ../../src/shared/... and ../../open-sse/...,
    VM_DEPLOYMENT_GUIDE.md omnirouteCloud reference replaced with a
    pointer to in-repo TUNNELS_GUIDE.md (omnirouteCloud lives in a
    separate companion repo).

Validation:
  npm run check:doc-links → PASS (501 internal links, 0 broken)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
diegosouzapw
2026-05-13 19:52:04 -03:00
parent acf6b93df2
commit 52f29f2347
16 changed files with 38 additions and 38 deletions

View File

@@ -200,8 +200,8 @@ can:
## Relationship with the Auto-Assessment RFC
A separate, narrower assessment subsystem lives at `src/domain/assessment/`
and is documented in [docs/RFC-AUTO-ASSESSMENT.md](./RFC-AUTO-ASSESSMENT.md).
That RFC targets the Auto Combo engine — automatically scoring providers and
(see also [AUTO-COMBO.md](../routing/AUTO-COMBO.md) for the live scoring engine).
That subsystem targets the Auto Combo engine — automatically scoring providers and
models so combos can self-heal when upstreams fail. It uses its own runner,
its own categorizer, and its own scoring logic.
@@ -245,6 +245,6 @@ Common changes and where to make them:
- [USER_GUIDE.md](../guides/USER_GUIDE.md) — overall product walkthrough
- [ARCHITECTURE.md](../architecture/ARCHITECTURE.md) — request pipeline reference
- [RFC-AUTO-ASSESSMENT.md](./RFC-AUTO-ASSESSMENT.md) — Auto Combo scoring
- [AUTO-COMBO.md](../routing/AUTO-COMBO.md) — Auto Combo scoring engine (live runtime)
- Source: `src/lib/evals/`, `src/lib/db/evals.ts`, `src/app/api/evals/`
- UI: `src/app/(dashboard)/dashboard/usage/components/EvalsTab.tsx`

View File

@@ -314,7 +314,7 @@ default TTL 5 min).
definitions alongside memory.
- [MCP-SERVER.md](./MCP-SERVER.md) — MCP transport / scopes.
- [API_REFERENCE.md](../reference/API_REFERENCE.md) — broader API surface.
- [Tuto_Qdrant.md](../Tuto_Qdrant.md) — repository-root Qdrant setup tutorial (integration currently dormant — see status banner at top of that file).
- [Tuto_Qdrant.md](../../Tuto_Qdrant.md) — repository-root Qdrant setup tutorial (integration currently dormant — see status banner at top of that file).
- Source modules:
- `src/lib/memory/types.ts`, `schemas.ts`
- `src/lib/memory/store.ts`, `retrieval.ts`, `injection.ts`