Skip to content

[style-harmonize] retrofit 5-field intro block on 4 recently-landed guides#35

Merged
weicao merged 1 commit intomainfrom
style-harmonize/intro-block-retrofit-batch-2
May 3, 2026
Merged

[style-harmonize] retrofit 5-field intro block on 4 recently-landed guides#35
weicao merged 1 commit intomainfrom
style-harmonize/intro-block-retrofit-batch-2

Conversation

@weicao
Copy link
Copy Markdown
Contributor

@weicao weicao commented May 3, 2026

Summary

Adds the standardized 5-field intro block (Audience / Status / Applies to / Applies to KB version / Affected by version skew) to 4 methodology guides that landed without it. Same retrofit pattern as PR #29 (case files batch).

Files (4)

Why this PR is low-risk

  • Pure structural addition: 6 lines per file (5 intro lines + blank separator)
  • No body content modified
  • No methodology claim altered
  • All four KB-version fields tagged any (engine-agnostic methodology, version-skew unaffected) per content type

Lineage

  • PR [style-harmonize] retrofit intro block on 9 case files #29 — first case-file intro block retrofit batch (9 case files)
  • This PR — methodology-guide intro block retrofit batch 2 (4 guides)
  • Future authors should add intro block at PR-author time per CONTRIBUTING.md (no further retrofit debt expected — Alice msg=8da1969a confirmed her next 4 guides will land with intro block in place)

Test plan

  • Each of the 4 files has the 5-line intro block immediately after H1, before existing body text
  • Markdown renders cleanly (blockquote with bold-key field labels)
  • No body content removed or modified

Adds the standardized 5-field intro block (Audience / Status / Applies to /
Applies to KB version / Affected by version skew) to 4 methodology guides
that landed without it. Same retrofit pattern as PR #29 (case files retrofit).

Files:

- docs/addon-controller-crash-resilience-guide.md (PR #23 land)
- docs/addon-ship-readiness-multi-phase-validation-guide.md (PR #24 land)
- docs/addon-design-contract-review-during-xp-guide.md (PR #34 land)
- docs/addon-pvc-rebind-via-workload-intent-guide.md (PR #33 land)

Pure structural addition: 6 lines per file, no body content modified, no
methodology claim altered.

All four KB-version fields: any (engine-agnostic methodology, version-skew
unaffected). Audience and Applies-to scoped per file content.
@weicao weicao merged commit 28a86fb into main May 3, 2026
weicao added a commit that referenced this pull request May 3, 2026
…100% format conformance (#45)

Closes format conformance gap on final 10 methodology guides without standardized 5-field intro block. Coverage 21/31 → 31/31 (100%). Pure structural addition (5 lines per file; host-stress 2 missing fields added keeping original 3). Same retrofit pattern as PR #29 + PR #35. No body content modified.
weicao added a commit that referenced this pull request May 4, 2026
…ection (#52)

Closes 6 nits across PR #50 + #51 (Fix validation sub-section abstracts / 设计教训 anti-pattern statements / Guard v1 strength progression abstracts / Source evidence index cross-repo path prefix) + adds new SKILL-INDEX ### OceanBase section with 2 case entries closing the cases/oceanbase/-to-SKILL-INDEX sync gap. Pure additive; methodology body unchanged. Same retrofit pattern as PR #29/#35/#41/#45/#48/#49.
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