Re: DPUB module comments

On 09/03/2015 11:21 PM, James Craig wrote:
> I believe the DPUB draft is going to confuse some authors. A few comments below:
> http://rawgit.com/w3c/aria/master/aria/dpub.html
>
> 1. Each of these roles should use the dpub- prefix to avoid confusion and name collision
>     with the main ARIA spec. If they are useful enough for mainstream adoption, we can
>     coordinate the names when the roles are pulled into the main ARIA spec. e.g. dpub-
>     chapter would very likely be adopted as an unprefixed ARIA role "chapter", but "dpub-
>     locator" is still just a link and would likely never be brought into the main spec.
>     Authors can specify these today as role="dpub-locator link" (this is a valid ARIA 1.0
>     syntax) and the UAs will fall back to the link role appropriately, while still allowing
>     parsers access to the dpub-specific role.
We agreed at the 7 January 2015 PF Editors meeting that for DPub we 
would waive the normal requirement for new role modules to have a 
prefix, because they are coordinating closely with us through the DPub 
ARIA task force. We committed to taking care during development, setting 
up a collision finding script, and using the ARIA role taxonomy 
documentation to help avoid creating similar roles with different names.

Michael
>
> 2. Roles should sub-level hyphenation. E.g. page-list should be dpub-pagelist.
>
> 3. Several of the roles are too generic. "part" for example.
>
> 4. Several of the roles are probably too specific. "learning-outcome" and "learning-
>     objective" for example.
>
> 5. Some should be expanded for clarity: "glossdef" and "qna" for example. ARIA roles don't
>     use abbreviations, with one notable exception: "img"... This was just an editorial
>     oversight that I hope to correct.
>
> 6. "landmarks" is going to confuse a lot of authors.
>
> 7. A non-abstract role name "abstract" is defined immediately after a sentence stating:
>     "Abstract roles are used for the ontology. Authors must not use abstract roles in
>     content." I recommend picking a different name, perhaps dpub-summary?
>

Received on Tuesday, 10 March 2015 18:45:08 UTC