From fd121c057e50077709534da6c3d9b35b88d77bac Mon Sep 17 00:00:00 2001
From: Brandon Hunt <101275235+brandonh6k@users.noreply.github.com>
Date: Mon, 6 Jul 2026 14:10:06 -0600
Subject: [PATCH 1/2] docs: add explicit single-page guide structure callout

---
 STYLE.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/STYLE.md b/STYLE.md
index aca8d1477e74..6b7148a6e5b2 100644
--- a/STYLE.md
+++ b/STYLE.md
@@ -305,6 +305,19 @@ don't front-load complexity.
 - Don't use "**Bold:** format" for subsection labels (use plain text
   with colon)
 
+### Guide structure
+
+Guides are single-page - don't split a guide into multiple sub-pages
+(for example, separate "overview", "configure", and "deploy" pages for
+one guide). Cover the full task on one page and use headings to
+organize sections.
+
+Store each guide as a single Markdown file directly under
+`content/guides/` (for example, `content/guides/django.md`), not
+wrapped in its own directory with an `index.md`. Guide images belong in
+the shared `content/guides/images/` folder, prefixed with the guide's
+slug, not in a per-guide directory - see [Images](#images).
+
 ### Lists
 
 - Limit bulleted lists to five items when possible
@@ -396,6 +409,13 @@ For code block syntax, language hints, variables, and advanced features
 - Compress images before adding to repository
 - Remove unused images from repository
 
+**File organization:**
+
+- Store guide images in the shared `content/guides/images/` folder,
+  not in a per-guide directory
+- Prefix filenames with the guide's slug to avoid collisions (for
+  example, `kafka-architecture.webp`)
+
 For image syntax and parameters (sizing, borders), see
 [COMPONENTS.md](COMPONENTS.md#images).
 

From 3a54daf566238a8fa53bc9b2872544382c273504 Mon Sep 17 00:00:00 2001
From: Brandon Hunt <101275235+brandonh6k@users.noreply.github.com>
Date: Mon, 6 Jul 2026 16:13:59 -0600
Subject: [PATCH 2/2] docs: use consistent file+anchor link style for Images
 reference

---
 STYLE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/STYLE.md b/STYLE.md
index 6b7148a6e5b2..d412d0775c90 100644
--- a/STYLE.md
+++ b/STYLE.md
@@ -316,7 +316,7 @@ Store each guide as a single Markdown file directly under
 `content/guides/` (for example, `content/guides/django.md`), not
 wrapped in its own directory with an `index.md`. Guide images belong in
 the shared `content/guides/images/` folder, prefixed with the guide's
-slug, not in a per-guide directory - see [Images](#images).
+slug, not in a per-guide directory - see [Images](STYLE.md#images).
 
 ### Lists