Skip to content

docs: sync after #402 (activity count) and #394 (page count, site assembly) - #403

Merged
Sev7eNup merged 1 commit into
mainfrom
docs/auto-sync-2026-09-22
Sep 22, 2026
Merged

Sev7eNup merged 1 commit into
mainfrom
docs/auto-sync-2026-09-22

Conversation

@Sev7eNup

Copy link
Copy Markdown
Owner

What & why

Automated documentation-drift sync for the pull requests active in the last 26 hours. Every figure
below was verified against the checked-out code on main, not inferred from a diff.

Doc Claim Reality on main Caused by
README.md (×2) reference table "All 29 activities"; solution tree "29 activities" 27 — ActivityCatalog.cs holds 27 entries #402
README.md (×2) documentation site has 43 pages per language 44 — data/nav.ts routes 44 paths, content/de and content/en hold 44 .md files each #394
CONTRIBUTING.md assemble:site runs "from the two finished builds"; output lists root / docs/ / media/; preview:site "runs both builds" assemble-site.mjs requires three builds (dist, dist-site, ../nodepilot-ui/dist-demo) plus pages-media, and also writes demo/; preview:site runs build, build:site and build:demo #394

The activity count is a regression, not stale prose

#402 was a copy-editing pass described as having no factual changes. It did change one: it rewrote
two 27 activities claims to 29 while leaving the highlights bullet at 27, so the README
contradicted itself. DocumentationCountsTests pins only the highlights bullet
(with (\d+) activity types), which is exactly why the other two could drift unnoticed. Every
other surface — doc site concepts/workflows.md in both languages, and the website i18n/{de,en}.ts —
already says 27.

Relationship to #399

#399 carries the page-count and site-assembly corrections but is mergeable_state: dirty: #402
rewrapped the very paragraphs it patches, so its hunks no longer apply. Those two fixes are
re-applied here against current main. #399 is superseded and can be closed.

How

Text only. No code, config or test changes.

Testing

Nothing executable changed, so no suite applies. The figures are derived from the repository rather
than asserted:

  • 27 = grep -cE '(Action|Logic|ControlFlow)\("' src/NodePilot.Core/Activities/ActivityCatalog.cs
  • 44 = grep -cE "\{ path: '" src/nodepilot-docs-ui/src/data/nav.ts, matching 44 .md files in each
    of content/de and content/en (the two sets are identical).
  • Assembly inputs read off REQUIRED_INPUTS / cpSync in scripts/assemble-site.mjs and the
    preview:site script in package.json.

All 18 DocumentationCountsTests rows were re-derived against the code and match
(MCP tools 102, default 92, destructive 10, activity types 27, skins 10, 234 Vitest files,
77 E2E specs); CLAUDE.md is 54,934 bytes, under the 60,000 cap.

  • Docs updated (README / CLAUDE.md / docs/ / docs-ui content/de/ and content/en/) if behavior or config changed
  • Branched off main; no direct commits to main

The docs-site corpus does not duplicate either corrected fact, so no content/{de,en} mirror was
needed: the page count appears only in the README, and the site-assembly instructions only in
CONTRIBUTING.md and CLAUDE.md (which already described the three required inputs).

Not applied here

Nothing. The dependency bumps in the window (#396, #397, #398, #401) touch only package.json,
lockfiles and Directory.Packages.props, with no user-facing or contractual surface, so no
docs-drift issue was filed.


Generated by Claude Code

…nputs

Automated documentation-drift sync. Three claims disagreed with the code on
main; all were verified against the checked-out source rather than inferred
from a diff.

README.md — activity count (regression from #402)
  The copy-editing pass rewrote "All 27 activities" to 29 in the reference
  table and "27 activities" to 29 in the solution tree, while the highlights
  bullet kept 27, so the file contradicted itself. ActivityCatalog.cs holds 27
  entries and every other surface (doc site de/en, website i18n de/en) says 27.
  DocumentationCountsTests guards only the highlights bullet, which is why the
  other two drifted unguarded.

README.md — documentation site page count (from #394)
  43 pages corrected to 44: data/nav.ts routes 44 paths and content/de and
  content/en hold 44 .md files each, the two sets being identical.

CONTRIBUTING.md — site assembly (from #394)
  assemble:site was described as taking two finished builds and writing root,
  docs/ and media/. assemble-site.mjs requires three builds (dist, dist-site,
  ../nodepilot-ui/dist-demo) plus pages-media and also writes demo/, and every
  input is mandatory. preview:site runs build, build:site and build:demo. The
  missing build:demo bullet is added.

Text only; no code, config or test changes.
@Sev7eNup
Sev7eNup merged commit 6d85911 into main Sep 22, 2026
9 checks passed
@Sev7eNup
Sev7eNup deleted the docs/auto-sync-2026-09-22 branch September 22, 2026 20:54
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