From 1f859c2378a49d6e9b64838bfe792cee17423383 Mon Sep 17 00:00:00 2001
From: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
Date: Tue, 13 Jan 2026 12:14:21 -0800
Subject: [PATCH] docs: clarify header budget vs structure template
 relationship

Add note explaining that structure templates show content flow, not 1:1
header mapping. Admonitions and inline elements are within sections.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/_STYLE_GUIDE.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/_STYLE_GUIDE.md b/docs/_STYLE_GUIDE.md
index 2eeb833e..be73c9d3 100644
--- a/docs/_STYLE_GUIDE.md
+++ b/docs/_STYLE_GUIDE.md
@@ -37,6 +37,8 @@ These rules apply to ALL document types. Violations fail review.
 - `###` subsections: 2-3 per `##` section max
 - `####`: Never use
 
+Structure templates below show content flow, not 1:1 header mapping. Admonitions and inline elements appear within sections, not as separate headers.
+
 ### Header Naming
 
 | Context | Style | Example |