Skip to content

docs(api): remove AI writing patterns from v2001 handbook - #175

Closed
nerdalytics wants to merge 1 commit into
trunkfrom
docs/unslop-v2001-handbook
Closed

nerdalytics wants to merge 1 commit into
trunkfrom
docs/unslop-v2001-handbook

Conversation

@nerdalytics

Copy link
Copy Markdown
Owner

Summary

Style-only pass over the 15 pages in handbook/src/routes/v2001.0.0/ that the /latest glob serves. Dashes and mid-sentence colons in prose become periods, commas or "such as". Bold-label lists become sentences. Filler, hedging and AI vocabulary are cut.

Code blocks, numbers, links, frontmatter and VersionLink markup are unchanged. Each hunk was checked for meaning changes.

Verification

  • npm run build (root): exit 0
  • npm run lint (root): Checked 62 files, no errors
  • npm run build (handbook): exit 0
  • npm run check (handbook): COMPLETED 374 FILES 0 ERRORS 0 WARNINGS

Not in this PR

  • derive, migration and settle pages still have em dashes in new upstream text (the async section, the v2000 to v2001 migration page, and the settle page). These need a second pass.
  • handbook/src/lib/navigation.ts links to /select and /lens (lines 64 and 71). Neither page exists under v2001.0.0.
  • installation/+page.md:92 says "There are no subpath exports". package.json declares ./hooks.
  • derive/+page.md:334 comments ReferenceError: c is not defined. Node reports Cannot access 'c' before initialization for this pattern.
  • Benchmark figures on state and performance disagree with each other, and the source of the state figures is unknown.

Style-only pass over the 15 v2001.0.0 handbook pages that the
latest tree now maps to. Replaces em dashes and mid-sentence
colons in prose, converts bold-label lists to sentences, and cuts
filler and AI vocabulary. Code blocks, numbers, links and
VersionLink markup are unchanged.
@nerdalytics

Copy link
Copy Markdown
Owner Author

Superseded by #176, which covers all handbook version trees under a new branch name.

@nerdalytics
nerdalytics deleted the docs/unslop-v2001-handbook branch October 18, 2026 15:23
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