Skip to content

docs(onboarding): re-verify the primer against current source - #221

Merged
ivanball merged 1 commit into
mainfrom
docs/onboarding-primer-refresh
Sep 26, 2026
Merged

ivanball merged 1 commit into
mainfrom
docs/onboarding-primer-refresh

Conversation

@ivanball

Copy link
Copy Markdown
Owner

Summary

Every checkable claim in docs-src/onboarding/00-primer.md was re-verified against MMCA.Common, ADC, Store and Helpdesk at origin/main (2026-09-26) and against the current ADR files; each correction was re-checked against the source before it was applied. Source edit plus the regenerated render, search index and sitemap.

  • Section 1: 22 packages per FACTS.md (adds the AI group, Testing.Aspire, AI.Testing), the AI package layer boundary, moved LayerEnforcement.targets citation.
  • Section 2: decorator chain gains Authorization and Timeout (queries validate too), RS256 is the JwtSettings default (HS256 is the explicit monolith opt-in), four engines and four context classes (PostgreSQL, ADR-113), audit-trail interceptor order, identifier alias counts (two Guid, seventeen int), moved citations, device-matrix pointer.
  • ADR table: rows 006, 014, 018, 035 (412, not 409), 036 (Apple), 058 (seven bases), 059, 064 (fourth freshness gate), 069 (Store adopted), 070 (IOptions<T>, no facades), 078 (X-Export-Row-Limit), 085, 093 (postures closed), 106 now match their ADR text; nine g27 labels that pointed at the group-28 chapter corrected.
  • Section 3: eight stale package versions, PostgreSQL provider, Redis health check replacement; adds AI, Cronos, Serilog, Testcontainers and BenchmarkDotNet entries.
  • Sections 4 to 6: moved .editorconfig, Directory.Build.props and workflow citations; the rubric coverage matrix is linked instead of promised.

Verification

  • npm run build: 251 pages, dead cross-links: none.
  • Diff touches only the primer source, its render, search-index.json and sitemap.xml.

Merging publishes the live site.

Generated with Claude Code

Every checkable claim in 00-primer.md re-verified against MMCA.Common,
ADC, Store and Helpdesk at origin/main and the ADR files.

- Section 1: 22 packages (AI group, Testing.Aspire, AI.Testing), the AI
  layer boundary, moved LayerEnforcement.targets citation.
- Section 2: decorator chain gains Authorization and Timeout (queries
  validate), RS256 is the JwtSettings default, four engines and four
  context classes (PostgreSQL), audit-trail interceptor order, identifier
  alias counts, moved citations, device matrix pointer.
- ADR table: rows 006, 014, 018, 035 (412), 036 (Apple), 058, 059, 064,
  069, 070, 078, 085, 093, 106 match their current ADR text; g27 labels
  that pointed at group-28 corrected.
- Section 3: eight package versions, PostgreSQL provider, Redis health
  check replacement, plus AI, Cronos, Serilog, Testcontainers,
  BenchmarkDotNet entries.
- Sections 4-6: moved editorconfig/props/workflow citations; the rubric
  coverage matrix is linked rather than promised.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ivanball
ivanball merged commit a7b0641 into main Sep 26, 2026
4 checks passed
@ivanball
ivanball deleted the docs/onboarding-primer-refresh branch September 26, 2026 22:01
ivanball added a commit that referenced this pull request Sep 26, 2026
…ers (#222)

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>
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