joelniklaus HF Staff commited on
Commit
e3e245a
·
1 Parent(s): 5ea1a40

update agents.md with directives for charts

Browse files
Files changed (1) hide show
  1. AGENTS.md +4 -0
AGENTS.md CHANGED
@@ -56,6 +56,10 @@ Use these blog posts as inspiration for writing style:
56
  - Treat figures as first-class content, not decoration
57
  - **All images/plots must be wrapped as figures** (using `<figure>` with `id` and `<figcaption>`) and every figure must be mentioned in the surrounding text using `<FigRef target="figure-id" />`. Do NOT include "Figure N:" in `<figcaption>` text since the figure environment auto-numbers
58
  - Interactive elements should reveal insight, not just look fancy
 
 
 
 
59
  - Ensure all visualizations work in dark mode
60
  - Mobile-friendly is mandatory
61
 
 
56
  - Treat figures as first-class content, not decoration
57
  - **All images/plots must be wrapped as figures** (using `<figure>` with `id` and `<figcaption>`) and every figure must be mentioned in the surrounding text using `<FigRef target="figure-id" />`. Do NOT include "Figure N:" in `<figcaption>` text since the figure environment auto-numbers
58
  - Interactive elements should reveal insight, not just look fancy
59
+ - **Hover tooltips everywhere**: Add informative hover tooltips wherever possible to surface additional detail (model name, exact values, metadata) without cluttering the chart
60
+ - **Readable text size**: Ensure all text in charts (axis labels, tick marks, legends, annotations) is large enough to read comfortably, comparable to the main body text size
61
+ - **Minimal padding**: Keep internal chart padding/margins small so the majority of space is used for actual content
62
+ - **Discuss every visualization**: Every chart must be cited in the surrounding text with `<FigRef>` and accompanied by 1–3 paragraphs that explain what the chart shows, highlight the key takeaway, and discuss implications
63
  - Ensure all visualizations work in dark mode
64
  - Mobile-friendly is mandatory
65