search

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

WCAG-pagina's schrijven #561

Open Robbert opened 10 months ago

Robbert commented 10 months ago

We willen voor elke WCAG SC een pagina op nldesignsystem.nl, van daar uit kunnen we linken naar alle protips. Maak voor alle losse WCAG SC's een issue als je inspiratie hebt voor allemaal extra content.

Voortgang werk Zie milestone WCAG-pagina's

rianrietveld commented 10 months ago

Plek: Niet in het menu, maar wel intern naar linken

rianrietveld commented 9 months ago

@Yolijn / @robbert, voordat ik hiermee aan de slag ga, wil ik eerst het volgende opzet aan jullie voorleggen:

Voorstel voor opzet. We gaan uit van WCAG 2.2 AA. Waar we nu linken naar de understanding pagina op de W3C site, linken we in deze constructie naar deze pagina's. De pagina's worden niet in het menu opgenomen. (Vraag: komt er wel een verzamelpagina?)

Per SC: Slug: /wcag/x-x-x-nederlandse-naam/ Titel (en H1) x.x.x Nederlandse naam niveau X

Inhoud: Korte Nederlandse samenvatting van het SC.

W3C referentie:

NLDS Richtlijnen:

Hoe te testen: Accessibility testing guide - UK Government Digital Service is hiervoor een goede bron. Gerelateerde test tools.

Afsluitend: Link naar GitHub-discussies om bij te dragen en vragen te stellen.

rianrietveld commented 9 months ago

Gerelateerd: #545. Ik sluit 545 en voeg de comments hier bij. Deze twee issues overlappen elkaar.

comment Hidde: Ik zie dat we soms naar Nederlands (WCAG), soms naar Engels (Understanding) en die laatste soms naar 2.1 en soms naar 2.2 gaan, dus die zouden we nog ff moeten nalopen en slimme keuze maken.

comment Robbert: Ik zou graag linken naar bijvoorbeeld: https://nldesignsystem/wcag2/1.3.5, vanwaar we kunnen linken naar diverse dingen:

Robbert commented 9 months ago

@rianrietveld Ik vind de Nederlandse identifier gebruiken in de URL een goed idee, we kunnen redirects instellen zodat de code werkt. Bijvoorbeeld:

https://nldesignsystem.nl/wcag/1.3.4 ➝ https://nldesignsystem.nl/wcag/weergavestand

Yolijn commented 9 months ago

Prima plan dit! 👍

rianrietveld commented 9 months ago

@Robbert Dus niet https://nldesignsystem.nl/wcag/1-1-1-niet-tekstuele-content maar https://nldesignsystem.nl/wcag/1.1.1 als url?

rianrietveld commented 9 months ago

Inspiratie: https://appt.org/en/guidelines/wcag/success-criterion-1-1-1

rianrietveld commented 9 months ago

Discussie over Focus Visible en Focus Appearance (Level AAA).

Inhoudelijke vraag voor de richtlijnen: voor Target size houden we WCAG AAA aan, ik zou hetzelfde willen doen voor Focus Visible. Voor AA is de native browser outline voldoende maar dat is soms heel onduidelijk en afhankelijk van de browser of het goed zichtbaar is. Ik wil graag de nieuwe richtlijn Focus Appearance (Level AAA) opnemen in onze richtlijnen. WCAG: When the keyboard focus indicator is visible, an area of the focus indicator meets all the following:

Robbert commented 9 months ago

Ik wil ook AAA aanhouden hier, geen halfslachtige oplossingen voor focus.