Re: [SVG-AAM] editorial: Accessible name calculation

Hi Chaals,

I'm working on the doc today, so I can make some changes.  This was
supposed to be the purpose of the note box at the end of section 5.6.1,
which currently says:

The net effect of these changes is to establish the following priority of
> alternative text values for the accessible name:
>
>    1. aria-labelledby
>    2. aria-label
>    3. a direct child title element
>    4. xml:title attribute
>    5. for a use element, the accessible name calculated for the re-used
>    content
>    6. for text container elements, the text content
>
> The alternative text values for the accessible description have the
> following priority:
>
>    1. aria-describedby
>    2. a direct child desc element
>    3. for a use element, the accessible description calculated for the
>    re-used content
>    4. for text container elements, the text content
>    5. a direct child title element that provides a tooltip, when ARIA
>    label attributes are used to provide a different accessible name
>
> The aria-labelledby and aria-describedby properties can reference the
> element on which they are given, in order to concatenate one of the other
> text alternatives with text from a separate element.


Do you think a more detailed jargon-free description is required?  Or can
we get by with that note box plus the complete algorithm text, highlighting
the modified sections?

Amelia

On 21 October 2015 at 09:07, Chaals McCathie Nevile <chaals@yandex-team.ru>
wrote:

> Hi,
>
> it is very hard to figure out what this section actually *says* clearly
> enough to review it sensibly. Even with two documents open, swapping
> between them to try and make the substitutions.
>
> Can you please
> 1) Put the full adjusted algorithm in the SVG-AAM document, and
> 2) Provide a clearer description of what gets included
>
> if you like I can make a pull request for the first request, but I haven't
> got to the point where I can confidently do the second.
>
> cheers
>
> Chaals
>
> --
> Charles McCathie Nevile - web standards - CTO Office, Yandex
>  chaals@yandex-team.ru - - - Find more at http://yandex.com
>
>