From d7c171b8057298428b8f34ce50ffbe887e27ffd6 Mon Sep 17 00:00:00 2001 From: iris Date: Wed, 2 Sep 2026 20:39:58 +0200 Subject: [PATCH] CLAUDE.md: add the summary-line markdown gotcha to the doc-split note argus's #3989 review caught it: a
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. --- CLAUDE.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 008f7a3b..4d6990f9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 `` line itself isn't markdown- + processed — backticks render as literal characters, not styled code + — so keep summary text plain prose, no inline-code formatting.