Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TLDR sectie toevoegen voor alle WCAG pagina's #1185

Closed
Robbert opened this issue Jul 16, 2024 · 0 comments · Fixed by #1202
Closed

TLDR sectie toevoegen voor alle WCAG pagina's #1185

Robbert opened this issue Jul 16, 2024 · 0 comments · Fixed by #1202
Assignees
Milestone

Comments

@Robbert
Copy link
Member

Robbert commented Jul 16, 2024

Acceptatiecriteria

  • Elk WCAG succescriterium heeft een pagina, met in elk geval de kop en de standaard links naar het W3C
  • Elke pagina begint met een ## TL;DR sectie (maar dan met een betere naam)
  • Voor elk WCAG success criterium wordt een intro tekst geschreven voor niet-technische gebruikers. De doelgroep is bijvoorbeeld mensen binnen een gemeente die voor een toegankelijkheidsverklaring betalen.
  • Als basis wordt de "Uitleg" genomen voor pagina's die al bestaan.
  • Voor de overige succes criteria worden de teksten als basis gebruikt die Robbert laatst had geschreven voor Frameless, en open source heeft gemaakt om bij te dragen aan NL Design System
  • De inhoud van de TLDR staat in een los partial bestandje, bijvoorbeeld _1.1.1-tldr.md
  • De tldr wordt geinclude in de wcag pagina, bijvoorbeeld:
import Samenvatting from "./_1.1.1-samenvatting.md";

## Samenvatting

<TooLongDidntRead />

## Uitleg
@Robbert Robbert assigned Robbert and rianrietveld and unassigned Robbert Jul 16, 2024
@rianrietveld rianrietveld added this to the WCAG-pagina's milestone Jul 16, 2024
Robbert added a commit that referenced this issue Jul 30, 2024
… nog ontbrekende nieuwe pagina's toe (#1202)

Gerelateerd issue: #1185
Preview:
https://documentatie-git-wcag-add-summary-nl-design-system.vercel.app/wcag/introduction

Nieuwe opzet:

In de directory wcag/summaries staan per succescriterium een korte
summary, die bovenaan bij de uitleg komt.
Ik heb het geen kopje samenvatting gegeven, maar opgenomen bovenaan de
uitleg.
De reden hiervan is dat de tekst bij de bestaande pagina's dan middenin
in tweeën gehakt wat raar leest.
Nu is het een geheel en heeft niemand er verder last van.

De summaries staan geheel op zichzelf en kunnen los worden ingevoegd bij
rapportage om als samenvatting te dienen.

Ik heb de tekst van Robbert geredigeerd, soms aangevuld, soms ingekort
en soms gewijzigd om het kloppend te maken. Per SC is er een commit die
de verschillen laat zien.

Verder zijn de links naar de WCAG-SC in de website aangepast naar de
interne pagina's. Ook heb ik de linkteksten uniform gemaakt.

Niet opgenomen uit het overzicht van Frameless:
- 1.2.6 is WCAG AAA, [Succescriterium 1.2.6 Gebarentaal (vooraf
opgenomen)](https://www.w3.org/Translations/WCAG22-nl/#gebarentaal-vooraf-opgenomen)
 niet opgenomen.
- 1.4.6 is WCAG AAA, [Succescriterium 1.4.6 Contrast
(versterkt)](https://www.w3.org/Translations/WCAG22-nl/#contrast-versterkt)

Ik wil hier eerst overleg over of we die uberhaubt opnemen, 1.4.6 kan ik
me voorstellen, maar 1.2.6 niet.


Toegevoegd (want stonden niet in het overzicht van van Frameless) zijn
de succescriteria 2.4.11, 2.5.7, 2.5.8, 3.2.6, 3.3.7 en 3.3.8

todo: review en changelog

---------

Co-authored-by: Robbert <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants