Re: Seeking feedback on draft of section on naming and describing

Review  of
https://raw.githack.com/w3c/aria-practices/zcorpan/labelling-describing/aria-practices.html#names_and_descriptions

Sectioin 5. Providing Accessible Names and Descriptions:typo in second
sentence. " While doing so is straight forward for most elements, technical
mistakes that can have devistating impacts..." should be "While doing so is
straight forward for most elements, technical mistakes that can have
devastating impacts..."

Sectioin 5. Providing Accessible Names and Descriptions: bullets within
this section should be formatted as EITHER sentence case OR title case,
match the heading of specific subsection and.listed in order of preference.
Change to numbered list from bulleted list to denote preference order.
Should probably be two lists: one for naming and a second list for
describing. Also each listitem should be a link to that specific subsection
which should also be ordered by preference. .
Example using title case and two lists ordered by preference:

   - Naming


   1. Naming by Encapsulation with a Label.
   2. Naming by Referencing Content Via aria-labelledby.
   3. Naming with a String Attribute Via aria-label.
   4. Naming with Child Content.
   5. Naming with Legends and Captions.
   6. Fallback Names Derived from Titles and Placeholders.


   - Describing


   1. Describing by Referencing Content with aria-details.
   2. Describing by Referencing Content with aria-describedby.
   3. Fallback Descriptions Derived from Titles and Placeholders. (Note: no
   section exists for this. Either add section or remove bullet.)

Sectioin 5.3.1.3 Rule 3: Prefer Native Techniques follows Section 5.3.1.2
Rule 2: Prefer Visible Text but, based on order of preference, 5.3.1.3 Rule
3: Prefer Native Techniques should be listed first.
Reorder subsections under 5.3.2 Naming Techniques to match order of
listitems under Sectioin 5. Providing Accessible Names and Descriptions.

Because naming and describing are two different constructs, care must be
taken to not confuse the reader by using 'describing' or 'description' or
"descriptiveness" when discussing or defining naming.

   - 5.3.1.5 Rule 5: Compose Brief, Useful Names

   In the same way that visually crowded screens reduce usability,
   excessively long or insufficiently distinct and descriptive (remove "and
   descriptive") accessible names can make a user interface very difficult, or
   even impossible, to use for someone who relies on a non-visual form of the
   user interface. In other words, for a web experience to be accessible, the
   names must be effective. The below section on Composing Effective and
   User-friendly Accessible Names
   <https://raw.githack.com/w3c/aria-practices/zcorpan/labelling-describing/aria-practices.html#naming_effectively>
   provides guidance for striking an effective balance between brevity and
   descriptiveness (change "descriptiveness" to "effectiveness" or
   "usefulness").

#4 Warning under 5.3.2.2 Naming with a String Attribute Via aria-label: typo
"When a user interface is translated into multiple languages, ensure that
aria-lable values..." should be " When a user interface is translated into
multiple languages, ensure that aria-label values..."

5.3.2.3 Naming with Referenced Content Via aria-labeledby includes a
"To-do" for code examples.
#1 Warning under 5.3.2.3 Naming with Referenced Content Via aria-labeledby:
typo
" The aria-labelledby property cannot be chained, i.e., if an element
with aria-labelled
by references..." should be " The aria-labelledby property cannot be
chained, i.e., if an element with aria-labelledby references..."

All subsequent sections contain To-do notations, indicating they are not
yet complete - review is pending completion.


Kind Regards,
Ann
annabbott@gmail.com
512-451-8267


On Mon, May 13, 2019 at 2:33 AM <a11ythinker@gmail.com> wrote:

> Hi All,
>
>
>
> I’d like to discuss the naming and describing section on Tuesday. Please
> read the current draft, which is about 80% complete, here:
>
>
> https://raw.githack.com/w3c/aria-practices/zcorpan/labelling-describing/aria-practices.html#names_and_descriptions
>
>
>
> This is a really important section. Please give it a read so we can have
> substantive discussion.
>
>
>
> At this point, I think I have built all of Jon’s feedback into the
> outline. Although, not all the content is complete; there is still several
> to-do’s related to that. There are some other placeholder to-do items as
> well.
>
>
>
> Some goals include:
>
>    1. Comprehensive: all important topics/issues should be addressed.
>    2. Easy to read: clarity of language and simplicity of examples is
>    paramount.
>    3. Easy to scan for specific information; an information architecture
>    that is easy to follow.
>    4. Practical, practical, practical …
>    5. Witout using anti-patterns, help people avoid naming blunders.
>
>
>
> Thanks,
>
> Matt
>