One rule per component
Our component docs got shorter and people started reading them.
5 min
Ilse Vos
Each component page in the Ostra library opens with one sentence: when to use it. Everything else is an example.
Why one
Two rules become five and nobody reads five. One rule gets quoted in reviews.
Where it breaks
Layout components need more than one sentence. We gave them diagrams instead.