Recently Written · git

ai-config

One canonical AI agent config (rules, skills, MCP servers) rendered into Claude Code, Codex, Copilot CLI and Antigravity by acsync

git clone https://github.com/equwal/ai-config

Log | Files | Refs


skills/impactful-writing/references/structure-patterns.md (11205 bytes)

1 # Content Structure and Formatting Patterns
2 
3 Research-backed principles for how to organize and present content.
4 
5 ## Contents
6 - Eye-Tracking and Reading Patterns
7 - The Inverted Pyramid
8 - White Space Science
9 - Headings and Subheadings
10 - Lists vs Paragraphs
11 - Chunking and Cognitive Load
12 - Mobile vs Desktop Behavior
13 - Scanability Optimization
14 
15 ## Eye-Tracking and Reading Patterns
16 
17 ### The F-Pattern (Nielsen Norman Group, 2006-2017)
18 
19 **Study details**: 232 users across thousands of web pages, tracked over 11 years
20 
21 **Three movements of the F-pattern:**
22 1. **Horizontal movement** across upper content (F's top bar)
23 2. **Second horizontal movement** lower down, typically shorter (F's lower bar)
24 3. **Vertical scan** down the left side (F's stem)
25 
26 **Key findings:**
27 - First two paragraphs receive most attention
28 - Left-aligned text gets 69% more visual attention
29 - Content on right side often ignored
30 - Users rarely read word-for-word; scanning is default
31 
32 ### Four Main Scanning Patterns (2019 Update)
33 
34 1. **F-Pattern**: Traditional horizontal-vertical scanning (least effective for content absorption)
35 
36 2. **Spotted Pattern**: Skipping to visually distinct elements
37    - Users focus on: links, bold text, bullets, numbers
38    - Effectiveness depends on highlighting key terms
39 
40 3. **Layer-Cake Pattern**: Scanning headings only (highly effective)
41    - Readers scan headings until finding relevant section
42    - Creates horizontal stripe pattern in heat maps
43    - "Aside from reading every word, the most effective scanning pattern"
44 
45 4. **Commitment Pattern**: Traditional reading (rare, 10-20% of users)
46    - Occurs when users highly motivated
47    - Most comprehensive but time-consuming
48 
49 ### Design Implications
50 
51 - **Most users read very little**: Assume scanning
52 - **Support scanning through**:
53   - Meaningful subheadings
54   - Bulleted lists
55   - Visual styling for keywords
56   - Chunked sections
57 - **79% of web visitors skim** rather than read every word
58 - **Average time on page: 15 seconds**
59 
60 ## The Inverted Pyramid
61 
62 ### Origin and Validation
63 
64 Journalism best practice validated by Nielsen Norman Group (2018).
65 
66 **Core principle**: Most important information first, followed by supporting details in descending order of importance.
67 
68 ### Benefits Measured
69 
70 - **Improved comprehension**: Users form mental models faster
71 - **Decreased interaction cost**: Main point understood without deep reading
72 - **Encourages scrolling**: 71% more likely to scroll when engaged by opening
73 - **Supports skimmers**: Users can stop at any point with understanding
74 
75 ### Structure
76 
77 | Section | Reader Reach | Content |
78 |---------|-------------|---------|
79 | First paragraph | 100% | The conclusion/main point |
80 | Second paragraph | 50-80% | Critical supporting details |
81 | Subsequent | 20% | Decreasing importance |
82 
83 ### Effectiveness Data
84 
85 - 20% higher comprehension scores
86 - 35% faster task completion
87 - 40% reduction in bounce rate
88 
89 ### Application
90 
91 ```
92 Traditional (avoid):
93 Background → Context → Details → Conclusion
94 
95 Inverted Pyramid (prefer):
96 Conclusion → Key Evidence → Supporting Details → Background
97 ```
98 
99 ## White Space Science
100 
101 ### Research Evidence
102 
103 **Key study** (Hurley Write, 2020): White space in margins improves comprehension by approximately 20%.
104 
105 ### Psychological Impact
106 
107 - Reduces visual clutter
108 - Decreases cognitive load by 18%
109 - Improves focus on key elements
110 - Creates perception of quality and professionalism
111 
112 ### Types of White Space
113 
114 **Macro white space**: Large gaps between major elements
115 - Increases comprehension by 20%
116 - Reduces eye strain
117 - Guides visual hierarchy
118 
119 **Micro white space**: Small gaps (line spacing, letter spacing)
120 - Improves readability by 12%
121 - Enhances text legibility
122 - Reduces reading fatigue
123 
124 ### WCAG Accessibility Requirements
125 
126 | Element | Requirement |
127 |---------|-------------|
128 | Line height | 1.5em (1.5× font size) |
129 | Paragraph spacing | 2em |
130 | Word spacing | 0.16em minimum |
131 | Letter spacing | 0.12em minimum |
132 
133 ### Practical Guidelines
134 
135 - Line height: 1.4-1.6 for body text
136 - Paragraph spacing: At least 1.5× line height
137 - Section spacing: 2-3× paragraph spacing
138 - Margins: Generous—white space is not wasted space
139 
140 ## Headings and Subheadings
141 
142 ### Eye-Tracking Evidence
143 
144 **Research findings** (Hyöna & Lorch, 2004-2006):
145 - Headings receive disproportionate attention
146 - Users spend 2-3x longer on headings than body text
147 - Layer-cake scanning: Many users read headings only
148 
149 ### Meta-Analysis on Text Structure
150 
151 **Bogaerds-Hazenberg et al. (2021):**
152 - Text structure instruction improves comprehension by 0.35 standard deviations
153 - Descriptive headings improve recall by 28%
154 - Hierarchical structure reduces cognitive load
155 
156 ### Best Practices
157 
158 **Effective headings are:**
159 1. **Descriptive**: Communicate content, not clever wordplay
160 2. **Front-loaded**: Key words at beginning
161 3. **Hierarchical**: Clear H1 → H2 → H3 structure
162 4. **Scannable**: Stand alone without context
163 5. **Specific**: 6-8 words optimal
164 
165 **Heading frequency:**
166 - Every 3-4 paragraphs for long-form content
167 - Every 300-500 words as rough guide
168 
169 ### Impact Data
170 
171 Sites with effective heading hierarchies show:
172 - 47% improvement in task completion
173 - 32% faster information retrieval
174 - 40% better user satisfaction
175 
176 ## Lists vs Paragraphs
177 
178 ### When Lists Win
179 
180 **Research findings (multiple studies):**
181 - 3x better recall of individual items in lists vs paragraphs
182 - Lists highlight key points more effectively
183 - Processing advantage for item-specific information
184 - 40% faster information retrieval
185 
186 **Lists excel for:**
187 - Enumerating features or steps
188 - Presenting options or choices
189 - Highlighting key takeaways
190 - Mobile interfaces (critical for scanability)
191 
192 ### When Paragraphs Work Better
193 
194 **Research caveats:**
195 - **Heterogeneous content**: Mixed information types work better in paragraphs
196 - **Context retention**: Lists can decrease recall of surrounding content by 15%
197 - **Narrative flow**: Complex arguments need paragraph structure
198 - **Relationships**: When items are interconnected
199 
200 ### Optimal List Implementation
201 
202 **Best practices from studies:**
203 - Lead-in sentence to frame the list
204 - Parallel structure (consistent grammar)
205 - Appropriate punctuation based on content
206 - One level deep maximum (nested lists -23% comprehension)
207 - 2 sentences maximum per bullet point
208 
209 **Nielsen Norman Guideline**: Use lists when you have 3+ related items; use paragraphs for narrative or complex relationships.
210 
211 ## Chunking and Cognitive Load
212 
213 ### The Science
214 
215 **George Miller (1956)**: Working memory holds 5-9 "chunks" of information.
216 
217 **Modern application** (Nielsen Norman Group, 2016):
218 - Breaking content into chunks improves processing
219 - Chunks should represent meaningful units
220 - Optimal chunk size: 3-5 related items
221 
222 ### Chunking Strategies
223 
224 1. **Paragraph breaks**: Visual breathing room
225 2. **Subheadings**: Topic boundaries
226 3. **Lists**: Related items grouped
227 4. **Visual separators**: Borders, spacing, color blocks
228 5. **Progressive disclosure**: Reveal complexity gradually
229 
230 ### Impact Data
231 
232 | Metric | Improvement |
233 |--------|-------------|
234 | Comprehension | +24% |
235 | Perceived difficulty | -31% |
236 | User confidence | +28% |
237 | Cognitive load | Significantly reduced |
238 
239 ### Practical Implementation
240 
241 **For articles/blog posts:**
242 - Break every 3-4 paragraphs with heading
243 - Limit paragraphs to 3-5 sentences
244 - Use lists for enumeration
245 - Add visual breaks between major sections
246 
247 **For documentation:**
248 - One concept per section
249 - Code examples as visual chunks
250 - Progressive complexity
251 - Clear section boundaries
252 
253 ## Mobile vs Desktop Behavior
254 
255 ### Behavioral Differences
256 
257 | Factor | Mobile | Desktop |
258 |--------|--------|---------|
259 | Session length | 40-60% shorter | Baseline |
260 | Peak times | Morning (6-9 AM), evening | Work hours (9 AM-6 PM) |
261 | Bounce rate | +32% for poor optimization | Baseline |
262 | Scrolling | 50% more | Less |
263 | Content preference | Light, quick updates | Deeper research |
264 
265 ### Reading Pattern Differences
266 
267 **Mobile behavior:**
268 - More rapid scanning
269 - Thumb-driven scrolling
270 - Higher abandonment on dense text
271 - Preference for bite-sized content
272 
273 **Desktop behavior:**
274 - Deeper reading for research
275 - Tolerance for longer content
276 - Mouse-driven precision scanning
277 
278 ### Mobile-Specific Optimization
279 
280 **Critical adjustments:**
281 1. Shorter paragraphs: 3-4 lines maximum
282 2. More white space: 1.5-2x desktop spacing
283 3. Larger tap targets: 44×44 pixels minimum
284 4. Stronger hierarchy: Bigger heading distinctions
285 5. Front-loaded content: Even more critical
286 
287 **Research finding**: Mobile users show 60% better comprehension when content is specifically optimized for mobile.
288 
289 ## Scanability Optimization
290 
291 ### Why Scanability Matters
292 
293 **User behavior data:**
294 - Users read 20-28% of words on a page
295 - Average time on page: 15 seconds
296 - Decision to stay/leave: First 10 seconds
297 - 80% of users scan; 20% read thoroughly
298 
299 ### Elements That Enhance Scanability
300 
301 **Ranked by impact (eye-tracking studies):**
302 
303 | Element | Scanner Engagement |
304 |---------|-------------------|
305 | Headings/Subheadings | 89% |
306 | Bulleted lists | 70% |
307 | Bold/emphasized text | 65% |
308 | Short paragraphs (first lines) | 58% |
309 | Images with captions | 45% |
310 | Numbers and data | 42% |
311 | Pull quotes | 38% |
312 | White space | 35% |
313 
314 ### The Scanability Formula
315 
316 **Optimal content structure:**
317 - **Headings**: Every 3-4 paragraphs
318 - **Paragraph length**: 3-5 sentences maximum
319 - **Sentence length**: 15-20 words average
320 - **Lists**: For 3+ related items
321 - **Bold keywords**: 2-3 per section
322 - **Line length**: 50-75 characters
323 - **White space**: 40-60% of page
324 
325 ## Gestalt Principles for Content
326 
327 ### Key Principles
328 
329 **1. Proximity**: Related items should be close together
330 - Reduces cognitive effort by 19%
331 - Creates implicit groupings
332 - Users process grouped items as single units
333 
334 **2. Similarity**: Similar items perceived as related
335 - Consistent formatting creates patterns
336 - Users scan 23% faster
337 - Reduces learning curve
338 
339 **3. Continuity**: Eyes follow continuous lines/patterns
340 - Guides reading flow
341 - Creates visual hierarchy
342 - Improves navigation by 35%
343 
344 **4. Figure/Ground**: Content vs background separation
345 - Essential for readability
346 - 4.5:1 contrast ratio minimum (WCAG AA)
347 - Proper contrast reduces strain
348 
349 ### Application to Content
350 
351 - Use proximity to group related paragraphs
352 - Apply similarity in heading styles consistently
353 - Create continuity with alignment and spacing
354 - Ensure figure/ground with adequate contrast
355 
356 ## Practical Checklist
357 
358 ### Before Publishing
359 
360 **Structure:**
361 - [ ] Inverted pyramid: Key point in first paragraph
362 - [ ] Headings every 3-4 paragraphs
363 - [ ] Paragraphs 3-5 sentences maximum
364 - [ ] Lists for 3+ related items
365 
366 **Formatting:**
367 - [ ] Line length 50-75 characters
368 - [ ] Adequate white space (line height 1.5+)
369 - [ ] Bold for 2-3 key terms per section
370 - [ ] Consistent heading hierarchy
371 
372 **Scanability:**
373 - [ ] First 10 seconds capture attention
374 - [ ] Key points visible without scrolling
375 - [ ] Visual hierarchy guides the eye
376 - [ ] Content works without reading every word
377 
378 **Mobile:**
379 - [ ] Paragraphs 3-4 lines on mobile
380 - [ ] Tap targets adequate (44×44px)
381 - [ ] Front-loaded content
382 - [ ] Tested on actual mobile device