docs: organize canonical documentation layout (URGENTE)

Group all existing authored guides by domain and ownership, expose complete navigation, and preserve their public routes. Update physical path consumers and release configuration while retaining historical records. Document domain-based specs and ADR slugs without global numbering.

Co-Authored-By: Codex <noreply@openai.com>
This commit is contained in:
Matheus Breguêz
2026-10-12 18:44:55 -03:00
co-authored by Codex
parent 3ee6ff43c1
commit ea504fac97
119 changed files with 1646 additions and 902 deletions
+9 -4
View File
@@ -83,14 +83,19 @@ export const documentationFactIssues = async (root, catalog) => {
issues,
path,
content,
"(docs/installation.md#supported-agents)",
"(docs/getting-started/installation.md#supported-agents)",
);
requireText(issues, path, content, "(docs/installation.md#mcp-registry)");
requireText(
issues,
path,
content,
"(docs/mcp-contracts.md#generated-catalog)",
"(docs/getting-started/installation.md#mcp-registry)",
);
requireText(
issues,
path,
content,
"(docs/reference/mcp-contracts.md#generated-catalog)",
);
}
}
@@ -109,7 +114,7 @@ export const documentationFactIssues = async (root, catalog) => {
)
issues.push(`${path}: documentation links differ from README.md`);
const installationPath = "docs/installation.md";
const installationPath = "docs/getting-started/installation.md";
const installation = await readFile(join(root, installationPath), "utf8");
for (const client of catalog.setup_clients)
requireText(issues, installationPath, installation, client.display_name);
+1 -1
View File
@@ -4,7 +4,7 @@ import assert from "node:assert/strict";
* `requireFunctionDossierOracle` is only used inside `verifyRealHopperFixture`,
* which runs against the real Hopper bridge after `build:cached`. Loading it
* lazily keeps this module importable from `test:fast` (which docs promise to
* run "without build" — see docs/testing.md § test scripts) so that mock-only
* run "without build" — see docs/development/testing.md § test scripts) so that mock-only
* callers such as `requireCurrentDocument` and `resolveFixtureProcedure` do
* not require `dist/`.
*/
+2 -1
View File
@@ -418,7 +418,8 @@ export async function verifyInventoryHistory(run, raw, source) {
"package-lock.json",
"server.json",
"src/generatedPackageMetadata.ts",
"docs/installation.md",
"docs/installation.md", // Historical releases before documentation organization.
"docs/getting-started/installation.md",
`docs/releases/${inventory.version}.contributions.json`,
]);
const paths = (
+1 -1
View File
@@ -9,7 +9,7 @@ import { Ajv2020 } from "ajv/dist/2020.js";
* file. `verifyCompleteToolCatalog` is the only consumer, so we lazy-load
* the module there and keep the other helpers (`exec`, `run`, `json`,
* `pathExists`) usable from `test:fast` callers that only need `dist/`-free
* utilities — see docs/testing.md § test scripts, which promises `test:fast`
* utilities — see docs/development/testing.md § test scripts, which promises `test:fast`
* runs "without build".
*/
const loadMcpVerifierResults = () => import("./mcp-verifier-results.mjs");