Skip to content

docs(checklist): align with post-structural-fix ownership and baselines#33

Merged
mghabin merged 1 commit into
mainfrom
docs/checklist-refresh
Apr 30, 2026
Merged

docs(checklist): align with post-structural-fix ownership and baselines#33
mghabin merged 1 commit into
mainfrom
docs/checklist-refresh

Conversation

@mghabin

@mghabin mghabin commented Apr 30, 2026

Copy link
Copy Markdown
Owner
  • Add baseline header (.NET 10 / C# 14 / Aspire 9.x for net8/9, Aspire 13
    for net10) and point readers at decision-trees first.
  • §7 HTTP/resilience: correct the default — standard handler retries ALL
    HTTP methods; require DisableForUnsafeHttpMethods() unless the callee
    exposes idempotency keys. Link ch02 §7 (single owner) and tree 15.
  • §9 Auth: enforce two separate policies (delegated scp vs app-only
    roles+azp allow-list); explicitly forbid OR-claims assertions. Link
    ch02 §10 and tree 12.
  • §10 Caching: split OutputCache (ch02 §9) vs HybridCache/IDistributedCache
    (ch03 §14); link tree 13.
  • §11 Data: add transactional outbox rule pointing at ch03 §6 (single
    owner) and forbid distributed/two-phase transactions.
  • §15 Cloud-native: enforce canonical /health/live, /health/ready,
    /health/startup probe contract per ch06 §10; split Aspire packages by
    AppHost vs service-project responsibility per tree 16; ServiceDefaults
    caveat called out.
  • Convert mixed lists to chapter-style Do / Don't paragraph leads
    for cross-doc consistency.
  • Add primary-source citations (Microsoft Learn, IETF RFCs, kubernetes.io,
    aspire.dev, w3.org) to normative claims and link every section to its
    owning chapter section anchor.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

- Add baseline header (.NET 10 / C# 14 / Aspire 9.x for net8/9, Aspire 13
  for net10) and point readers at decision-trees first.
- §7 HTTP/resilience: correct the default — standard handler retries ALL
  HTTP methods; require DisableForUnsafeHttpMethods() unless the callee
  exposes idempotency keys. Link ch02 §7 (single owner) and tree 15.
- §9 Auth: enforce two separate policies (delegated scp vs app-only
  roles+azp allow-list); explicitly forbid OR-claims assertions. Link
  ch02 §10 and tree 12.
- §10 Caching: split OutputCache (ch02 §9) vs HybridCache/IDistributedCache
  (ch03 §14); link tree 13.
- §11 Data: add transactional outbox rule pointing at ch03 §6 (single
  owner) and forbid distributed/two-phase transactions.
- §15 Cloud-native: enforce canonical /health/live, /health/ready,
  /health/startup probe contract per ch06 §10; split Aspire packages by
  AppHost vs service-project responsibility per tree 16; ServiceDefaults
  caveat called out.
- Convert mixed lists to chapter-style **Do** / **Don't** paragraph leads
  for cross-doc consistency.
- Add primary-source citations (Microsoft Learn, IETF RFCs, kubernetes.io,
  aspire.dev, w3.org) to normative claims and link every section to its
  owning chapter section anchor.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mghabin mghabin merged commit f6e2115 into main Apr 30, 2026
3 checks passed
@mghabin mghabin deleted the docs/checklist-refresh branch April 30, 2026 15:26
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