From 7d0b901be49a76f8ae2fb23352c273833cbe2ead Mon Sep 17 00:00:00 2001 From: yinlianghui-tw Date: Mon, 24 Aug 2026 16:05:55 +0000 Subject: [PATCH] docs(tooling): record the component-registry category-list entry as discharged MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The doc-snippet ledger docblock narrated `guide/component-registry`'s six category lists in the PRESENT tense — "are markdown BULLET LISTS inside `tsx` fences ... so it is declared here and left to its own change" — while every neighbouring entry is a past-tense round record. PR #6056 re-fenced those six blocks as plain markdown lists and removed the six FRAGMENT_MARKER declarations with them, so the sentence describes a tree that no longer exists: a reader who goes looking for those fences on the page finds nothing there. Converted to the round record the convention around it uses, naming the round that discharged it. The entry is kept rather than deleted — this ledger deliberately keeps the history of why each declaration existed. Comment prose only: no strictness change, no behaviour change, no ledger entry added or removed. Nothing asserts on this docblock, which is why nothing would ever have failed to prompt the correction — and why nothing keeps the new text true either. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_019b5UBNMtTzKbVtZZGvFuxe --- scripts/check-doc-snippet-types.mjs | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/scripts/check-doc-snippet-types.mjs b/scripts/check-doc-snippet-types.mjs index 6f9434d0f5..a5312c69a0 100644 --- a/scripts/check-doc-snippet-types.mjs +++ b/scripts/check-doc-snippet-types.mjs @@ -314,10 +314,16 @@ const TS_FENCE_LANGUAGES = new Set(['ts', 'tsx', 'typescript']); * in this program. Hoisting a package to the repo root to buy a doc snippet * coverage is a real dependency edge, so those blocks are declared instead, with * what sits underneath them measured (via a shimmed icon import) rather than left - * unknown. `guide/component-registry`'s six category lists are markdown BULLET - * LISTS inside `tsx` fences — the fence language is the defect there, and - * correcting it is a change to the page's rendering rather than to a snippet, so it - * is declared here and left to its own change. + * unknown. `guide/component-registry`'s six category lists were markdown BULLET + * LISTS inside `tsx` fences — the fence language was the defect there rather + * than anything in the blocks, so they were declared here and left to their own + * change. objectui#5997 (PR #6056) then made that change: the six fences are + * plain markdown bullet lists on the page now, which takes those blocks out of + * the ts/tsx population this gate collects at all, so the six `FRAGMENT_MARKER` + * declarations came out with them — a marker on a block the gate no longer + * collects is debt nothing would ever fail to prompt the removal of. The entry + * stays here because this ledger keeps the record of why each declaration + * existed, not because the page still carries them. * * objectui#5343 then read that list back and cleared it for the getting-started * pages: no entry for `content/docs/guide/**` or for