Queste pagine spiegano come usare Grigna. Sono scritte per due lettori:
- Persone (designer, sviluppatori): trovate il perché delle scelte, quando usare un elemento e quando no, esempi giusti e sbagliati.
- Agenti AI: ogni pagina chiude con una sezione Per gli agenti, con regole brevi e verificabili, nomi esatti di classi e token e cosa non inventare mai.
Le regole generali per gli agenti stanno in AGENTS.md, nella radice del progetto.
Come sono fatte le pagine dei componenti
Tutte hanno le stesse sezioni, nello stesso ordine, così si trovano le cose senza cercarle:
- Esempio dal vivo: il componente com'è davvero, subito sotto il titolo. Nel Markdown è un blocco
html anteprima. - Cos'è: una frase.
- Quando usarlo / Quando non usarlo
- Codice: HTML da copiare.
- Varianti e stati
- Token: i token del componente.
- Accessibilità
- Per gli agenti: regole Sempre e Mai.