Example Gallery

This gallery provides ten concrete examples designed for GitHub Pages documentation.

Each example includes:

• A realistic manifest you can copy and adapt
• Suggested interpretation prompts for teaching, QA, or onboarding
• A brief “when to use” note
• Data source and refresh notes for monthly updates

All manifests in this gallery are refreshed monthly from third-party public sources, as long as those sources continue publishing compatible data.

Gallery Index

1. Column Unemployment Example (United States, Monthly)
2. Line Trend Example (U.S. Median Age)
3. Multi-Line Sector Comparison Example (U.S. GDP by Industry)
4. Scatter Clusters Example (Old Faithful Geyser Eruptions)
5. Single-Line Unemployment Example (United States, 10-Year)
6. Donut Energy Composition Example (U.S. Electricity)
7. Scatter Live Macro Relationship (U.S. Unemployment vs Inflation)
8. Heatmap Live Hourly Pattern (New York City Temperatures)
9. Waterfall Live Contribution Breakdown (U.S. Electricity)
10. Stepline Live Policy-Rate Timeline (U.S. FEDFUNDS)
11. Column Inflation Snapshot (U.S., Last 24 Months)
12. Multi-Line Policy Rate and Unemployment (U.S., Last 6 Years)
13. Bar Chart Electricity Top Movers (U.S., Month-over-Month)
14. Scatter Policy Response (U.S. Unemployment vs Federal Funds Rate)

Data Sources And Refresh Policy

• Data is pulled from BLS, U.S. Census, BEA, Eurostat, FRED, and EIA.
• Cached manifests are refreshed monthly via GitHub Actions.
• Monthly refresh updates data values in manifest JSON files, not chart code or example page wiring.
• Existing cached data is retained until replacement data is downloaded and validated.
• Availability depends on third-party publication schedules and endpoint stability.

Expanded Backlog (What Is Missing)

The current monthly live-data updater and validation pipeline can refresh manifest data for these chart types now:

• line
• column
• bar
• donut
• scatter
• heatmap
• waterfall
• stepline

Chart-Family Examples That Need Runtime Validation Or Wiring

1. Lollipop Ranked Movers (Live)
   • Status: partially wired (uses bar chart info path today)
   • Next step: add dedicated example page and verify keyboard/label behavior.
2. Venn Overlap Summary (Static-First, Then Live If Source Supports True Intersections)
   • Status: runtime class exists
   • Next step: choose a source that provides real overlap counts (avoid synthetic intersections unless clearly labeled).
3. Histogram Distribution (Live)
   • Status: view/settings exist but chart-info registration is not enabled in current chart mapping
   • Next step: wire and validate before publishing live docs page.
4. Gauge Target Tracking (Live)
   • Status: settings exist; dedicated chart wiring remains incomplete
   • Next step: validate chart-info and rendering path prior to example rollout.
5. Graphing Functions Playground Example
   • Status: documented in control panel narratives, not yet represented as a stable docs example path
   • Next step: define manifest contract and add an education-focused example page.

How To Use This In Demos

• Start with the business question.
• Show the chart manifest and explain data encoding choices.
• Ask interpretation prompts before revealing answers.
• Compare visual reading with keyboard/screen-reader/sonification exploration.

This model is adapted from the successful pattern used in fizzstudio/ParaCharts-demo: one chart page plus focused interpretation questions.