- From: Michael Cooper <cooper@w3.org>
- Date: Fri, 29 Sep 2017 18:11:29 -0400
- To: AG WG <w3c-wai-gl@w3.org>
- Message-ID: <eb87fb29-2cb8-a484-6307-13d4d241aa86@w3.org>
One thing the QA checklist
<https://www.w3.org/WAI/GL/wiki/WCAG_2.1_QA_Checklist> mentions is that
the definitions of terms in WCAG 2 should be able to be replaced
directly into the SC and things still make sense. To test this, I added
a script that will substitute definitions in place of terms, if the
"defs" parameter is present in the URI, i.e.,
https://rawgit.com/w3c/wcag21/master/guidelines/index.html?defs
The script only substitutes the first line of the definition, since that
is the part that's meant to be drop-in replaceable. It puts the original
term that was linked into the title attribute of the replaced link, to
help figure out what was originally there (I could also make that more
directly visible if people want). The script may only work with newer
browsers, and only if the base script has run - there should be a
"Respec" button in the top right fairly early in the navigation order,
and the page may need to be refreshed if that hasn't shown up.
A few observations / comments:
* Some SC become very unwieldy when expanded this way, though that's
why we moved a lot of content to terms;
* There are WCAG 2.0 terms that don't work out well this way, but I
don't think we will fix that, this is mainly to look at WCAG 2.1
quality;
* The group may decide it wants to be less particular than me about
exact drop-in ability of definitions, but I still think it's a
useful exercise and a rough goal we should maintain for consistency
and understandability;
* Some SC may become fairly nonsensical and that should be a cue that
our definition isn't working well and needs improvement.
I'll leave it at that for now, people can look over the guidelines with
this filter as it suits them and raise any flags you see. I expect
eventually to file issues on terms I think really aren't working out
seen in this context.
Michael
Received on Friday, 29 September 2017 22:11:31 UTC