This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 27801 - Use Respec feature for Conformance section and consistently mark sections as "non-normative"
Summary: Use Respec feature for Conformance section and consistently mark sections as ...
Status: RESOLVED FIXED
Alias: None
Product: ARIA
Classification: Unclassified
Component: General (show other bugs)
Version: 1.1
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Michael Cooper
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-01-11 23:37 UTC by Jason Kiss
Modified: 2018-05-03 20:57 UTC (History)
0 users

See Also:


Attachments

Description Jason Kiss 2015-01-11 23:37:22 UTC
For consistency, the ARIA spec and all the AAM documents (Core, HTML, SVG, AccName, etc.) should use the terms "normative" and "non-normative" (as opposed to "informative", which some of them currently use). The non-normative status of a section should be declared using the feature in Respec that takes care of this, i.e. applying class="informative" to the relevant <section>.

Respec adds the following text to the "Conformance" section of the document:

"As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

The key words [list of  RFC2119 key words used in the document] are to be interpreted as described in [RFC2119]."

Drawing on what's currently in the Core-AAM, I propose we supplement the Respec text with the following:

"These RFC2119 key words are formatted in uppercase and contained in a strong element with class="rfc2119". When these key words are used, but do not share this format, they do not convey any formal conformance requirements in the RFC2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usage is avoided in this specification.

The classification of a section as normative or non-normative applies to the entire section and all sub-sections of that section.

Normative sections provide requirements that authors, user agents, and assistive technologies MUST follow for an implementation to conform to this specification.

Non-normative sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification."