@@ -1494,7 +1494,7 @@ represent a systematic erosion of reader trust: a reader who hits a broken link,
14941494an image that won't pull, or a typo in a field name they're about to paste into
14951495production has reason to distrust the entire page.
14961496
1497- ##### 1. Replace unofficial and internal dev images in examples
1497+ #### 1. Replace unofficial and internal dev images in examples
14981498
14991499> Priority: High — 17 occurrences across 11+ files
15001500
@@ -1515,7 +1515,7 @@ references in one PR, then add a CI linting rule (e.g., a grep check on
15151515` registry.k8s.io ` or known internal registry host names in Markdown code blocks)
15161516to prevent regressions.
15171517
1518- ##### 2. Fix broken and stale links
1518+ #### 2. Fix broken and stale links
15191519
15201520> Priority: High — 15 occurrences across 10+ files
15211521
@@ -1539,7 +1539,7 @@ treat link failures as blocking. For the `master`-branch API reference links,
15391539this is the same fix as the broader API link scheme recommendation (see
15401540Information Architecture §2) — a single pass replaces all of them.
15411541
1542- ##### 3. Remove or update deprecated API references
1542+ #### 3. Remove or update deprecated API references
15431543
15441544> Priority: High — 6 occurrences across 5 files
15451545
@@ -1563,7 +1563,7 @@ SME judgment — they are factually wrong or out of date. Batch into a single
15631563"deprecated API cleanup" PR. Add the Presets deprecation admonition immediately
15641564as it actively misleads users into using a feature that is being removed.
15651565
1566- ##### 4. Fix user-visible typos in code and API field names
1566+ #### 4. Fix user-visible typos in code and API field names
15671567
15681568> Priority: High — 6 occurrences, some in copy-pasteable code
15691569
@@ -1573,7 +1573,7 @@ as it actively misleads users into using a feature that is being removed.
15731573changes. The field name typos are especially damaging because users copy them
15741574verbatim and then debug why their manifest doesn't work.
15751575
1576- ##### 5. Remove or archive outdated historical content
1576+ #### 5. Remove or archive outdated historical content
15771577
15781578> Priority: High/Medium — 11 occurrences
15791579
@@ -1600,15 +1600,15 @@ issue is resolved). Others (pre-v0.20 notes, `--delete-local-data`, OKD APB) can
16001600be deleted without verification — they describe behavior removed in Kubernetes
16011601or OKD versions that are no longer in the support matrix.
16021602
1603- ##### 6. Fix the JSON syntax error in the registration example
1603+ #### 6. Fix the JSON syntax error in the registration example
16041604
16051605> Priority: High — 1 occurrence
16061606
16071607(A06-B04-T01) See sheet for a JSON syntax error in the plugin registration
16081608example. A reader following this example will get an error with no indication
16091609the source is the doc. Fix immediately.
16101610
1611- ##### 7. Complete truncated and placeholder release notes entries
1611+ #### 7. Complete truncated and placeholder release notes entries
16121612
16131613> Priority: High/Medium — 2 occurrences
16141614
0 commit comments