CLAUDE.md: add the summary-line markdown gotcha to the doc-split note

argus's #3989 review caught it: a <details><summary> line isn't
markdown-processed, so backticks in it render as literal characters
rather than styled code. Worth banking now, before it gets rediscovered
per-file across the other ~19 docs #3902 still has to touch.
This commit is contained in:
iris 2026-09-02 20:39:58 +02:00 committed by mara
commit d7c171b805

View file

@ -217,4 +217,6 @@ with each other.
churn, works uniformly regardless of whether the doc already had a
clean boundary. Caveat: it only collapses in a rendered browser —
reading the file as raw text (`cat`, the Read tool) shows everything,
same as today.
same as today. Also: the `<summary>` line itself isn't markdown-
processed — backticks render as literal characters, not styled code
— so keep summary text plain prose, no inline-code formatting.