From 6d6540f502e695a011615b5bdebbcfd6535f773a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 15 Dec 2025 20:44:56 +0000 Subject: [PATCH] spec: add waffle-basic specification Created from issue #998 --- plots/waffle-basic/implementations/.gitkeep | 0 plots/waffle-basic/metadata/.gitkeep | 0 plots/waffle-basic/specification.md | 26 ++++++++++++++++++ plots/waffle-basic/specification.yaml | 30 +++++++++++++++++++++ 4 files changed, 56 insertions(+) create mode 100644 plots/waffle-basic/implementations/.gitkeep create mode 100644 plots/waffle-basic/metadata/.gitkeep create mode 100644 plots/waffle-basic/specification.md create mode 100644 plots/waffle-basic/specification.yaml diff --git a/plots/waffle-basic/implementations/.gitkeep b/plots/waffle-basic/implementations/.gitkeep new file mode 100644 index 0000000000..e69de29bb2 diff --git a/plots/waffle-basic/metadata/.gitkeep b/plots/waffle-basic/metadata/.gitkeep new file mode 100644 index 0000000000..e69de29bb2 diff --git a/plots/waffle-basic/specification.md b/plots/waffle-basic/specification.md new file mode 100644 index 0000000000..9f379dbc3b --- /dev/null +++ b/plots/waffle-basic/specification.md @@ -0,0 +1,26 @@ +# waffle-basic: Basic Waffle Chart + +## Description + +A waffle chart displays proportions using a grid of equal-sized squares where colored squares represent parts of a whole. Each square typically represents 1% of the total, making it easy to count and compare values visually. It provides an intuitive alternative to pie charts, offering more accurate perception of proportions. + +## Applications + +- Visualizing survey results and polling data to show response distributions +- Displaying budget allocation across spending categories +- Tracking progress towards goals (e.g., fundraising at 73% of target) +- Showing demographic breakdowns in population studies + +## Data + +- `category` (categorical) - Category labels for each segment +- `value` (numeric) - Proportions or percentages for each category +- Size: 2-6 categories typical +- Note: Values should sum to 100 or be normalized to percentages + +## Notes + +- Standard grid is 10x10 (100 squares) where each square = 1% +- Use distinct, contrasting colors for each category +- Include a legend identifying categories with their percentages +- Round values to whole squares for clean visualization diff --git a/plots/waffle-basic/specification.yaml b/plots/waffle-basic/specification.yaml new file mode 100644 index 0000000000..e0711abc3d --- /dev/null +++ b/plots/waffle-basic/specification.yaml @@ -0,0 +1,30 @@ +# Specification-level metadata for waffle-basic +# Auto-synced to PostgreSQL on push to main + +spec_id: waffle-basic +title: Basic Waffle Chart + +# Specification tracking +created: 2025-12-15T20:44:32Z +issue: 998 +suggested: MarkusNeusinger +history: [] + +# Classification tags (applies to all library implementations) +tags: + plot_type: + - waffle + - proportion + domain: + - general + - business + - statistics + features: + - basic + - part-to-whole + - grid + audience: + - beginner + data_type: + - categorical + - numeric