added some learnings to agents.md

AGENTS.md

@@ -34,6 +34,7 @@ Use these blog posts as inspiration for writing style:
 - **Inline code** for technical identifiers: model names, hyperparameters, file paths
 - Lists for features, steps, or comparisons
 - Keep paragraphs short (3-5 sentences max)
+- **Minimize horizontal scrolling in tables**: If a table row has long content that causes horizontal overflow, convert it to a bullet list or restructure the information. Prefer lists over tables when rows have variable-length prose
 
 ## Structure
 
@@ -48,10 +49,12 @@ Use these blog posts as inspiration for writing style:
 - Concrete examples over abstract explanations
 - Show, don't tell: prefer an interactive demo over a paragraph of description
 - Link to sources, don't just cite them
+- **Never show plain URLs as link text**: Always integrate links into descriptive text (e.g., write `[DataTrove inference benchmark](https://github.com/...)` not `[github.com/huggingface/datatrove/...](https://github.com/...)`)
 
 ## Interactivity
 
 - Treat figures as first-class content, not decoration
+- **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
 - Interactive elements should reveal insight, not just look fancy
 - Ensure all visualizations work in dark mode
 - Mobile-friendly is mandatory
@@ -115,6 +118,7 @@ The bibliography file is organized into these sections (in order). Always place
 | `<Glossary>` | Hover definitions for terms |
 | `<Quote>` | Attributed quotations |
 | `<Stack>` | Multi-column layouts |
+| `<FigRef>` | Auto-numbered figure cross-references (e.g., `<FigRef target="my-figure-id" />` renders as "Figure 3") |
 
 ## Chart Selection