spec: add scatter-annotated specification

[github-actions]

New Specification: scatter-annotated

Related to #2790

---

specification.md

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

---

Next: Add approved label to the issue to merge this PR.

---

🤖 spec-create workflow