spec: add scatter-annotated specification

plots/scatter-annotated/specification.md

@@ -0,0 +1,28 @@
+# scatter-annotated: Annotated Scatter Plot with Text Labels
+
+## Description
+
+A scatter plot where each data point can have a text label annotation, useful for identifying specific points of interest. This visualization enhances basic scatter plots by adding contextual information directly on the chart, making it easy to highlight outliers, named entities, or key data points that deserve special attention.
+
+## Applications
+
+- Labeling company names on a market cap vs. revenue scatter plot
+- Identifying outlier cities in a population vs. area analysis
+- Annotating key experiments in a scientific study comparing two measurements
+- Highlighting top performers in a sales vs. customer satisfaction comparison
+
+## Data
+
+- `x` (numeric) - Independent variable values plotted on the horizontal axis
+- `y` (numeric) - Dependent variable values plotted on the vertical axis
+- `label` (string) - Text annotation to display near each point
+- Size: 10-50 points recommended to avoid label overlap and maintain readability
+- Example: Named data points with random coordinates demonstrating typical annotation patterns
+
+## Notes
+
+- Use adjustText or similar libraries to avoid overlapping labels where supported
+- Consider annotating only a subset of important points for large datasets
+- Text should be legible with appropriate font size and contrast
+- Include subtle connecting lines or arrows from labels to points when offset
+- Points should have moderate transparency (alpha ~0.7) to reveal any overlap

plots/scatter-annotated/specification.yaml

@@ -0,0 +1,29 @@
+# Specification-level metadata for scatter-annotated
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: scatter-annotated
+title: Annotated Scatter Plot with Text Labels
+
+# Specification tracking
+created: 2025-12-30T17:35:03Z
+updated: null
+issue: 2790
+suggested: MarkusNeusinger
+
+# Classification tags (applies to all library implementations)
+# See docs/concepts/tagging-system.md for detailed guidelines
+tags:
+  plot_type:
+    - scatter
+    - point
+  data_type:
+    - numeric
+    - continuous
+  domain:
+    - general
+    - business
+    - research
+  features:
+    - annotated
+    - labeled
+    - 2d