Skip to content

docs(onboarding): carry the primer's drift fixes into the other chapters - #222

Merged
ivanball merged 1 commit into
mainfrom
docs/onboarding-chapters-drift
Sep 26, 2026
Merged

ivanball merged 1 commit into
mainfrom
docs/onboarding-chapters-drift

Conversation

@ivanball

Copy link
Copy Markdown
Owner

Summary

Follow-up to #221. Every onboarding chapter was scanned for the stale facts corrected in the primer (package count, decorator chain, HS256 default, three engines / one context class, alias counts, 409 vs 412, OAuth providers, conformance-base count, AppDomain discovery, freshness-gate count, DataProtection adoption, settings facades, export header, container postures, extension-block counts, package versions, Redis health check, moved line citations, g27/g28 labels). Real hits, each checked against source:

  • CONCEPT-MAPS: one sealed context class per engine; PostgreSQL in the engine list.
  • group-07: a stale RowVersion is 412 on a [SupportsIfMatch] endpoint and 409 only on endpoints without it (ADR-035, SupportsIfMatchAttribute.cs:130-138).
  • group-14: DataSource engine list includes PostgreSQL.
  • group-28, devops-testing: twenty-two packages (five general test packages, AI.Testing covered in group-27), FACTS line refs, ci.yml:158.
  • devops-cicd: four freshness gates, not three.
  • primer: the ADR-035 row now states the ETag / If-Match contract (428 with no precondition, 412 when stale).

Left as is, deliberately: history quotes in 99-coverage-audit.md's change log, and two "Google/GitHub" mentions that faithfully mirror IExternalAuthBroker's own doc comment and the Identity test coverage.

Verification

  • Group chapters are rebuilt from Docs/Onboarding/parts by concat.ps1; a baseline run before editing reproduced every chapter unchanged, and the post-edit run changed only the three edited chapters.
  • npm run build: dead cross-links: none.

Merging publishes the live site.

Generated with Claude Code

Scanned every onboarding chapter for the stale facts corrected in the
primer (#221) and fixed the real hits:

- CONCEPT-MAPS: one sealed context class per engine, PostgreSQL added.
- group-07: a stale RowVersion is 412 under [SupportsIfMatch], 409 only
  on endpoints without it (ADR-035).
- group-14: the DataSource engine list includes PostgreSQL.
- group-28 and devops-testing: twenty-two packages, five general test
  packages plus AI.Testing in group-27; FACTS line refs; ci.yml:158.
- devops-cicd: four freshness gates, not three.
- primer: ADR-035 row states the ETag / If-Match contract (428 / 412).

Group chapters are rebuilt from Docs/Onboarding/parts by concat.ps1; a
baseline concat run reproduced every chapter unchanged before the edit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ivanball
ivanball merged commit 16b37df into main Sep 26, 2026
4 checks passed
@ivanball
ivanball deleted the docs/onboarding-chapters-drift branch September 26, 2026 22:51
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