Re: [REVIEW REQUEST] Action-1440: Fix issues associated with regions as landmarks

On 2015-01-29 11:26 AM, Joanmarie Diggs wrote:
> The changes related to Action-1440 have been merged into master. They
> include:
>
>    * Add the region role as a type of landmark role.
>    * Add requirement that authors MUST give a region a brief label that
>      describes the purpose of the content in the region.

Related to this author requirement is this statement:

"Authors SHOULD include the label inside of a heading whenever possible"

The phrase "label inside of a heading" is awkward.  If the intent is to 
use the heading as the label, then how about:

"Authors SHOULD use a heading for the region's label whenever possible."

>    * Remove the accessible name property from the section role.
>    * Change the superclass role from region to section for the following
>      roles: alert, grid, landmark, list, log, status, and tabpanel.
>    * Remove region as a superclass role of article, making document the
>      only superclass role of article.

The article role is defined as a "section", although the use of the word 
does not link to the section role:

"A *section* of a page that consists of a composition that forms an 
independent part of a document, page, or site."  (My emphasis).

I don't think the use of "section" here is the actual section role. But 
its use is potentially confusing.  If that's correct, how about:

"A document container within a page that consists of a composition that 
forms an independent part of a document, page, or site."

The use of "document container" is to contrast with a "widget container".

>    * Updated and augmented documentation for the region and landmark
>      roles.

Hope that's useful.

-- 
;;;;joseph.

'Array(16).join("wat" - 1) + " Batman!"'
            - G. Bernhardt -

Received on Thursday, 29 January 2015 16:54:29 UTC