nl-design-system / documentatie

Website met documentatie van NL Design system: componenten, patronen, richtlijnen etcetera. Development-versie: https://documentatie.vercel.app/
https://www.nldesignsystem.nl/
European Union Public License 1.2
12 stars 13 forks source link

Vermijd WCAG SC nummers in filenames acceptatiecriteria #1557

Open hidde opened 1 month ago

hidde commented 1 month ago

Mijn voorkeur zou zijn dat we binnen button een mapje hebben voor acceptance criteria, met daarin bestandsnamen die het criterium beschrijven, niet het gerelateerde WCAG criterium.

Klinkt misschien als een detail, maar ik denk dat zo'n structuur het duidelijker maakt dat we niet per se aan WCAG criteria gebonden zijn. Bovendien geven we het SC hier al mee als onderdeel van het item, dus de relatie is er al.

dus:

button
  index.mdx
  acceptance-criteria
    visible-acc-name.md
    button-size.md
    contrast.md

Als we letterlijk de tekst van een WCAG SC includen kunnen we dat natuurlijk wel rechtstreeks includen.

Robbert commented 2 weeks ago

Dit is in het verlengde van #1558