Skip to content

Move README reference sections into guides (cleanup S2b) - #228

Merged
nevermemo merged 4 commits into
mainfrom
docs/cleanup-s2b-readme
Oct 23, 2026
Merged

nevermemo merged 4 commits into
mainfrom
docs/cleanup-s2b-readme

Conversation

@nevermemo

Copy link
Copy Markdown
Owner

Cleanup after cycle 1, slice S2b (docs only).

  • README.md 370 -> 227 lines. Verbatim moves into new guides, each the single home of its subject:
    • docs/reference/mcp-and-rest.md: "MCP tools" (with "Language-server lifecycle") and "REST/OpenAPI surface"
    • docs/reference/cli.md: "CLI"
    • docs/reference/retrieval.md: "Retrieval behavior" and "Retrieval evaluation"
    • docs/development/module-boundaries.md: "Module boundaries and checks"
  • README keeps the newcomer path (languages, build and run, configuration, storage, security), lists the new guides under "Documentation", and gains one first-search example under "Build and run".
  • References that pointed at moved sections are repointed (README settings row, "see CLI", AGENTS.md, the documentation instructions, cross-file "see ..." in the guides). documentation.md rule 2 names the new homes.

Information-loss check: a section and token inventory of every tracked Markdown file before and after shows no change in ids, PR numbers, numbers, dates, statuses, conditions or negations. Only relative link targets changed with the new file depth. A separate review compared the moved text line by line, and the only differences are the deliberate repoints. cargo xtask docs check: 79 files, 266 relative links, 0 problems.

Not in this PR: Rust strings that name README sections (src/rest.rs OpenAPI descriptions, which a golden pins; xtask help; config/profile.rs comments), plus fact mismatches against the code. Both come in the next cleanup slice.

🤖 Generated with Claude Code

nevermemo and others added 4 commits October 24, 2026 00:42
README keeps the newcomer path (languages, build and run, configuration) and
points to the new homes: docs/reference/mcp-and-rest.md, docs/reference/cli.md,
docs/reference/retrieval.md and docs/development/module-boundaries.md. Moved
text is unchanged apart from relative link targets. README 370 -> 233 lines.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s sections

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…example

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nevermemo
nevermemo merged commit 09da959 into main Oct 23, 2026
8 checks passed
@nevermemo
nevermemo deleted the docs/cleanup-s2b-readme branch October 23, 2026 22:06
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