Initial commit

2025-11-30 08:38:26 +08:00
commit 41d9f6b189
304 changed files with 98322 additions and 0 deletions
--- a/skills/cognitive-design/resources/storytelling-journalism.md
+++ b/skills/cognitive-design/resources/storytelling-journalism.md
@@ -0,0 +1,473 @@
+# Storytelling & Journalism
+
+This resource provides cognitive design principles for data journalism, presentations, infographics, and visual storytelling.
+
+**Covered topics:**
+1. Visual narrative structure
+2. Annotation strategies
+3. Scrollytelling techniques
+4. Framing and context
+5. Visual metaphors
+
+---
+
+## Why Storytelling Needs Cognitive Design
+
+### WHY This Matters
+
+**Core insight:** People naturally seek stories with cause-effect and chronology - structuring data as narrative aids comprehension and retention.
+
+**Challenges of data storytelling:**
+- Raw data is heap of facts (hard to process)
+- Visualizations can be misinterpreted without guidance
+- Readers skim, don't read thoroughly
+- Need emotional engagement + factual accuracy
+
+**How cognitive principles help:**
+- **Narrative structure:** Context → problem → resolution (chunks information meaningfully)
+- **Annotations:** Guide attention to key insights (prevent misinterpretation)
+- **Self-contained graphics:** Include all context (recognition over recall, no split attention)
+- **Emotional engagement:** Appropriate imagery improves retention (Norman's emotional design)
+- **Progressive disclosure:** Scrollytelling reveals complexity gradually
+
+**Mental model:** Data journalism is guided tour, not data dump - designer leads readers to insights while allowing exploration.
+
+---
+
+## What You'll Learn
+
+**Five key areas:**
+
+1. **Narrative Structure:** Organizing data stories with beginning, middle, end
+2. **Annotation Strategies:** Guiding interpretation and preventing misreading
+3. **Scrollytelling:** Progressive revelation as user scrolls
+4. **Framing & Context:** Honest presentation avoiding misleading frames
+5. **Visual Metaphors:** Leveraging existing knowledge for new concepts
+
+---
+
+## Why Narrative Structure Matters
+
+### WHY This Matters
+
+**Core insight:** Human brains are wired for stories - we naturally seek cause-effect relationships and temporal sequences.
+
+**Benefits of narrative:**
+- Easier to process (story arc vs unstructured facts)
+- Better retention (stories are memorable)
+- Emotional engagement (narratives activate empathy)
+- Natural chunking (beginning/middle/end provides structure)
+
+**Mental model:** Like journalism's inverted pyramid, but for visual data - lead with context, build to insight, resolve with implications.
+
+---
+
+### WHAT to Apply
+
+#### Classic Narrative Arc for Data
+
+**Structure:** Context → Problem/Question → Data/Evidence → Resolution/Insight
+
+**Context (Set the stage):**
+```
+Purpose: Orient reader to situation
+Elements:
+- Title that frames the story: "How Climate Change is Affecting Crop Yields"
+- Subtitle/intro: Brief background (2-3 sentences)
+- Visuals: Overall trend or map showing scope
+
+Example:
+Title: "The Midwest Corn Belt is Shifting North"
+Subtitle: "Rising temperatures are pushing viable growing regions 100 miles northward"
+Visual: Map showing historical corn production zones vs current
+```
+
+**Problem/Question (Establish stakes):**
+```
+Purpose: Show why this matters, what's at stake
+Elements:
+- Specific question posed: "Will traditional farming regions remain viable?"
+- Visual highlighting problem area
+- Human impact stated (not just abstract data)
+
+Example:
+Question: "Can farmers adapt quickly enough?"
+Visual: Chart showing yield declines in traditional zones
+Impact: "1.5 million farming families affected"
+```
+
+**Data/Evidence (Show the findings):**
+```
+Purpose: Present data that answers question
+Elements:
+- Clear visualizations (chart type matched to message)
+- Annotations highlighting key patterns
+- Comparisons (before/after, with/without intervention)
+
+Example:
+Visual: Line chart showing yields 1980-2024 by region
+Annotation: "Southern regions declining 15%, northern regions up 22%"
+Comparison: States that adapted (Iowa) vs those that didn't
+```
+
+**Resolution/Insight (Deliver the takeaway):**
+```
+Purpose: Answer the question, provide conclusion
+Elements:
+- Main insight clearly stated
+- Implications for future
+- Call-to-action or next question (optional)
+
+Example:
+Insight: "Adaptation possible but requires 5-10 year transition"
+Implication: "Without support, smaller farms will struggle to relocate/retool"
+Next: "How can policy accelerate adaptation?"
+```
+
+---
+
+#### Opening Strategies
+
+**Lead with human impact:**
+```
+❌ "Agricultural productivity data shows regional variations"
+✓ "Sarah Miller's family has farmed Iowa corn for 4 generations. Now her yields are declining while her neighbor 200 miles north is thriving."
+
+Why: Concrete human story engages emotions, makes abstract data personal
+```
+
+**Lead with surprising finding:**
+```
+❌ "Unemployment rates changed over time"
+✓ "Despite recession fears, unemployment in Tech Hub cities fell 15% while national rates rose"
+
+Why: Counterintuitive findings capture attention
+```
+
+**Lead with visual:**
+```
+Strong opening image/chart that encapsulates story
+Followed by: "This is the story of..." text
+Why: Visual impact draws reader in
+```
+
+---
+
+## Why Annotation Strategies Matter
+
+### WHY This Matters
+
+**Core insight:** Readers scan rather than study - without guidance, they may miss key insights or misinterpret data.
+
+**Benefits of annotations:**
+- Guide attention to important patterns (preattentive cues)
+- Prevent misinterpretation (clarify what data shows)
+- Reduce cognitive load (don't make readers discover insight)
+- Enable skimming (annotations convey story even without deep read)
+
+**Mental model:** Annotations are like tour guide pointing out important sights - "Look here, notice this pattern, here's why it matters."
+
+---
+
+### WHAT to Apply
+
+#### Annotation Types
+
+**Callout boxes:**
+```
+Purpose: Highlight main insight
+Position: Near relevant data point, contrasting background
+Content: 1-2 sentences max
+Style: Larger font than body, bold or colored
+
+Example on line chart:
+Callout pointing to spike: "Sales increased 78% after campaign launch - highest growth in company history"
+```
+
+**Arrows and leader lines:**
+```
+Purpose: Connect explanation to specific data element
+Use: Point from text annotation to exact point/region on chart
+Style: Simple arrow, not decorative
+
+Example:
+Arrow from "Product launch" text to vertical line on timeline
+Arrow from "Outlier explained by data error" to specific point
+```
+
+**Shaded regions:**
+```
+Purpose: Mark time periods or ranges of interest
+Use: Highlight recessions, policy changes, events
+Style: Subtle shading (10-20% opacity), doesn't obscure data
+
+Example:
+Gray shaded region labeled "COVID-19 lockdown March-May 2020"
+Allows comparison of before/during/after in context
+```
+
+**Direct labels on data:**
+```
+Purpose: Eliminate legend lookups
+Use: Label lines/bars directly instead of separate legend
+Benefit: Immediate association, no cross-referencing
+
+Example on multi-line chart:
+Text "North Region" placed directly next to its line (not legend box)
+```
+
+**Contextual annotations:**
+```
+Purpose: Explain anomalies, provide necessary background
+Use: Note data quirks, methodological notes, definitions
+
+Example:
+"*Data unavailable for Q2 2020 due to reporting disruptions"
+"**Adjusted for inflation using 2024 dollars"
+```
+
+---
+
+#### Annotation Guidelines
+
+**What to annotate:**
+```
+✓ Main insight (what should reader take away?)
+✓ Unexpected patterns (outliers, inflection points)
+✓ Important events (policy changes, launches, crises)
+✓ Comparisons (how does this compare to baseline/benchmark?)
+✓ Methodological notes (data sources, limitations)
+
+❌ Don't annotate obvious patterns ("trend is increasing" when clearly visible)
+❌ Don't over-annotate (too many annotations = visual noise)
+```
+
+**Annotation placement:**
+```
+✓ Near the data being explained (Gestalt proximity)
+✓ Outside the chart area if possible (don't obscure data)
+✓ Consistent positioning (all callouts top-right, or all left, etc.)
+```
+
+---
+
+## Why Scrollytelling Matters
+
+### WHY This Matters
+
+**Core insight:** Complex data stories benefit from progressive revelation - scrollytelling maintains context while building understanding step-by-step.
+
+**Benefits:**
+- Progressive disclosure (fits working memory)
+- Maintains context (chart stays visible throughout)
+- Engaging (interactive vs passive reading)
+- Guided exploration (designer controls sequence)
+
+**Mental model:** Like flipping through graphic novel panels - each scroll reveals next part of story while maintaining continuity.
+
+---
+
+### WHAT to Apply
+
+#### Basic Scrollytelling Pattern
+
+**Structure:**
+```
+1. Sticky chart (stays visible as user scrolls)
+2. Text sections (scroll past, trigger chart updates)
+3. Smooth transitions (not jarring jumps)
+4. User control (can scroll back up to review)
+```
+
+**Example implementation:**
+
+**Section 1 (scroll 0%):**
+```
+Chart shows: Full trend line 2010-2024
+Text visible: "Overall growth trajectory shows steady increase"
+User sees: Big picture
+```
+
+**Section 2 (scroll 33%):**
+```
+Chart updates: Highlight 2015-2018 segment in color, rest faded
+Text visible: "First phase: Rapid growth following policy change"
+User sees: Specific period in context of whole
+```
+
+**Section 3 (scroll 66%):**
+```
+Chart updates: Highlight 2020 dip in red
+Text visible: "COVID-19 impact caused temporary decline"
+User sees: Anomaly explained
+```
+
+**Section 4 (scroll 100%):**
+```
+Chart updates: Full color restored, add projection (dotted)
+Text visible: "Projected recovery to pre-2020 trend by 2026"
+User sees: Complete story with future outlook
+```
+
+---
+
+#### Scrollytelling Best Practices
+
+**Transitions:**
+```
+✓ Smooth animations (300-500ms transitions)
+✓ Maintain reference points (axis don't jump)
+✓ One change at a time (highlight region OR add annotation, not both simultaneously)
+❌ Jarring jumps (disorienting)
+```
+
+**User control:**
+```
+✓ Can scroll back up to review
+✓ Scroll speed doesn't affect (trigger points based on position, not speed)
+✓ "Skip to end" option for impatient users
+✓ Pause/play if animations continue automatically
+```
+
+**Accessibility:**
+```
+✓ All content accessible without scrolling (fallback for screen readers)
+✓ Keyboard navigation supported
+✓ Works without JavaScript (progressive enhancement)
+```
+
+---
+
+## Why Framing & Context Matter
+
+### WHY This Matters
+
+**Core insight:** Same data can support different conclusions based on framing - ethical journalism provides complete context to avoid misleading.
+
+**Framing effects (Tversky & Kahneman):**
+- 10% unemployment vs 90% employed (same data, different emotional impact)
+- Deaths per 100k vs % survival (same mortality, different perception)
+
+**Ethical obligation:** Provide enough context for accurate interpretation
+
+---
+
+### WHAT to Apply
+
+#### Provide Baselines & Comparisons
+
+**Always include:**
+```
+✓ Historical comparison (how does this compare to past?)
+✓ Peer comparison (how does this compare to similar entities?)
+✓ Benchmark (what's the standard/goal?)
+✓ Absolute + relative (numbers + percentages both shown)
+
+Example: "Unemployment rises to 5.2%"
+Better: "Unemployment rises to 5.2% from 4.8% last quarter (historical average: 5.5%)"
+Complete context: Reader can judge severity
+```
+
+**Avoid cherry-picking:**
+```
+❌ Show only favorable time period (Q4 2023 sales up! ...but down overall year)
+✓ Show full relevant period + note any focus area
+
+Example:
+❌ "Satisfaction scores improved 15 points!" (cherry-picked one quarter)
+✓ Chart showing full 2-year trend (overall declining with one uptick quarter)
+```
+
+---
+
+#### Clarify Denominator
+
+**Percentages need context:**
+```
+❌ "50% increase!" (50% of what?)
+✓ "Increased from 10 to 15 users (50% increase)"
+✓ "Increased 50 percentage points (from 20% to 70%)"
+
+Confusion: Is it 50 percentage point increase or 50% relative increase?
+Clarity: State both absolute numbers and percentage
+```
+
+---
+
+#### Note Limitations
+
+**Methodological transparency:**
+```
+✓ Data source stated: "Source: U.S. Census Bureau"
+✓ Sample size noted: "n=1,200 respondents"
+✓ Margin of error: "±3% margin of error"
+✓ Missing data: "State data unavailable 2020-2021"
+✓ Selection criteria: "Only includes full-time employees"
+
+Purpose: Reader can assess reliability and applicability
+```
+
+---
+
+## Why Visual Metaphors Matter
+
+### WHY This Matters
+
+**Core insight:** Familiar metaphors leverage existing knowledge to explain new concepts - but only if metaphor resonates with audience.
+
+**Benefits:**
+- Faster comprehension (tap into existing schemas)
+- Memorable (concrete imagery aids recall)
+- Emotional connection (metaphors evoke feelings)
+
+**Risks:**
+- Misleading if metaphor doesn't fit
+- Cultural assumptions (metaphor may not translate)
+- Oversimplification (metaphor hides complexity)
+
+---
+
+### WHAT to Apply
+
+#### Choosing Metaphors
+
+**Effective metaphors:**
+```
+✓ Virus spread as fire spreading across map (leverages fire = spread schema)
+✓ Data flow as river (volume, direction, obstacles)
+✓ Economic inequality as wealth distribution pyramid
+✓ Carbon footprint as actual footprint size
+
+Why they work: Concrete, universally understood, structurally similar to concept
+```
+
+**Problematic metaphors:**
+```
+❌ Complex technical process as simple machine (oversimplifies)
+❌ Cultural-specific metaphors (e.g., sports metaphors for international audience)
+❌ Metaphors that contradict data (e.g., "economy is healthy" shown as growing plant - what if it's not growing?)
+```
+
+---
+
+#### Metaphor Guidelines
+
+**Test your metaphor:**
+```
+1. Does it help understanding or just decorate?
+2. Is it universally recognized by target audience?
+3. Does it accurately represent the concept?
+4. Does it oversimplify in misleading ways?
+5. Could it be misinterpreted?
+
+If any answer is problematic → reconsider metaphor
+```
+
+**Clarify limitations:**
+```
+When using metaphor, note where analogy breaks down:
+"While virus spread resembles fire spread, unlike fire, viruses can have delayed effects..."
+
+Prevents overgeneralizing from metaphor
+```
+