SC todo list
You can see the stats of each success criteria (SC) at [1]
Instructions
Read this whole section before submitting an SC
We need to putting the proposed Success Criteria (SC's) into the WCAG template
- Sign up to do a SC bellow
- Find the SC proposal at https://rawgit.com/w3c/coga/master/extension/index.html AND any wording changes at https://rawgit.com/w3c/coga/master/extension/rewroded%20sc%203.html
- make a new document for this success criteria based on the template: https://rawgit.com/w3c/coga/master/extension/template.html (note that this is based on Andrews template at https://github.com/w3c/wcag21/wiki/Proposals-for-new-Success-Criteria -but I added instructions and useful links)
- Add your document to coga github in the extension sub directory IE: https://github.com/w3c/coga/tree/master/extension (If this is hard then send it to Lisa)
I made a sample at : https://rawgit.com/w3c/coga/master/extension/support-personalization.html
Comply with: https://www.w3.org/WAI/GL/wiki/WCAG_2.1_Success_Criteria (see bellow)
Try to take all the relevant info from the techniques document (https://rawgit.com/w3c/coga/master/techniques/index.html) and issue papers.
The techniques document has lots of really good information and relevant techniques
pass and failure examples and there are Sources/research cited The benefits section must fully make the case for the change.
In the benefits section we need to focus on explaining the new material to them and explain why changes were needed.
It is really really important, as we want to get these passed, to do this we really want to:
- show the benefits including any evidence and
- show test-ability
- make it clear
It is worth looking at wcag 2.O such as https://www.w3.org/TR/UNDERSTANDING-WCAG20/text-equiv-all.html to see the kind of wording used in WCAG.
You can see an example of a general test procedure here:https://www.w3.org/TR/2016/NOTE-WCAG20-TECHS-20160317/G92.html#G92-tests
Some thing we need to clarify that people with cognitive disabilities include many types of disabilities such as:
- Language related disabilities
- Memory related disabilities
- Focus and attention related disabilities
- Executive and decision making disabilities
Hopefully feedback will be collected at https://github.com/w3c/wcag21/labels/COGA
Success Criteria Requirements
Taken from https://www.w3.org/WAI/GL/wiki/WCAG_2.1_Success_Criteria
These requirements are provided as guidance to the WCAG Working Group as it works to define new Success Criteria in WCAG 2.1. The guidance here may be changed by the working group if necessary.
Success Criteria shall:
- Address a situation where a user with a disability will be disproportionately disadvantaged (as compared to a user without a disability) if the criteria is not met.
- Be testable through automated or manual processes.
- Describe the specific condition required to meet the criteria, not the method to address the criteria.
- Utilize the WCAG 2.0 A/AA/AAA level structure.
- Ensure for revised Success Criteria that pages that meet the revised guidance continue to meet the corresponding WCAG 2.0 Success Criteria.
- Apply to all content unless preconditions for the application of the success criteria are explicitly identified (e.g. "except interruptions involving an emergency").
- Apply across technologies to the greatest extent possible. (Technology-specific issues should usually be addressed in Techniques.)
- Avoid creating a requirement for something that is already required by an existing Success Criterion.
- Have Success Techniques which demonstrate that each Success Criterion is implementable, using readily-available formats, user agents, and assistive technologies.
Success Criteria should:
- Be as broad as possible, but specific enough not to become a 'catch-all' for any given requirement.
- Use glossary definitions to simplify and shorten all Success Criteria for shared or ambiguous terms.
Checklist for proposals for new Success Criteria or to change existing Success Criteria
Each proposed SC is provided on its own page, and that page (location of the page TBD, likely on GitHub) contains:
- The SC text.
- If suggesting a wording change to an existing success criteria, write the complete SC text and then follow that with a version which indicates the changes by surrounding new text with "@@". For example (just an example), "1.4.3 Contrast (Minimum): The visual presentation of @@text, images of text, and icons@@ has a contrast ratio of at least 4.5:1, except for the following: (Level AA)".
- Suggestion for Priority Level (A/AA/AAA).
- Indication of any suggested glossary definitions or changes.
- What Principle and Guideline it falls within (or suggestion for new guideline)
- A description of what the intent of the SC is, including what users benefit from the content successfully addressing it (examples are helpful, but not required).
- Clear information about how the proposal will benefit users, along with justification and evidence of the benefits (this may be a link to a separate resource).
- Description of how this SC can be tested.
- Possible technique titles which could be used to satisfy the SC (just the title).
Success Criteria Best Practice Guidelines
The Working Group is striving for WCAG 2.1 to be as clear as possible, and has established the following as Best Practice Guidance. For groups submitting Success Criteria proposals, these are guidelines and are not intended to be absolute. For example, a SC proposal may be written using notes or lists if the proposal is deemed clearer as a result, however, the Working Group may restructure the content upon further review for clarity.
- Ensure that the criteria is written as simply as possible without loss of clarity or testability. SC are better when they:
- Are concise and clear
- Minimize the use of lists to where they make the success criteria easier to follow. When lists are necessary numbered lists are preferred to more easily allow referencing specific items
- Avoid the use of "notes" to make the criteria clear (Notes are regarded as Normative in WCAG 2.0 and 2.1)
- Avoid jargon and unnecesarily complex language.
- The SC can be summarized into a simple language sentence that describes its theme
Volunteer
- Use semantics and safe standardized techniques that enable the content to be adapted to the user scenario including enabling additional support and personalization.
- Allocated to: Lisa
- New version: https://rawgit.com/w3c/coga/master/extension/support-personalization.html
- pending preliminary comments from WCAG at https://github.com/w3c/wcag21/issues/6
- change Guideline 3.1: Make text content readable and understandable to Make content readable and understandable
- Allocated to: Lisa
- New version: https://rawgit.com/w3c/coga/master/extension/3-1.html
- ready for WCAG review at https://github.com/w3c/wcag21/issues/7 - DO NOT EDIT
- Timed event are not used except for the situations listed below.
- Allocated to: Thad:
- New version: https://rawgit.com/w3c/coga/master/extension/timed-events.html
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#timed
- Status: Pending review
- Do not expose user information in a way that can be exploited without informed consent
- Allocated to: John K
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#do-not-expose-user-information-in-a-way-that-can-be-exploited-without-informed-consent
- Status:
- Do not add mechanisms that are likely to confuse the user in a way that may do them harm and use known techniques to keep the user safe.
- Allocated to: John Rochford
- New version: https://rawgit.com/w3c/coga/master/extension/safety.html
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#semantics
- Status: rewording needed
- Instructions, labels, navigation and important information are provided with a clear writing style that includes
- Allocated to: Deborah Dahl,
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#instructions
- Status:
- Provide a clear structure and layout (new guidline)
- Allocated to: Lisa (reassigned)
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#Providea%20clearstructureandlayout
- Status:
- Information is provided in manageable chunks, that include:
- Allocated to: EA
- New version:https://rawgit.com/w3c/coga/master/extension/chunks.html
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#chunks
- Status:
- Add to WCAG 3.2.4
- Allocated to: Ayelet Seeman
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#3.2.4
- Status:
- The main purpose of each page and section of content is obvious
- Allocated to: Steve
- New version:https://rawgit.com/w3c/coga/master/extension/clear-purpose.html
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#obvious
- Interactive controls are visually clear or visually clear controls are easily available that conform to the following:
- Allocated to: Mary Jo
- New version:
- Original version: "https://rawgit.com/w3c/coga/master/extension/index.html#controls"
- A familiar design, layout and common icons are easily available
- Allocated to: EA
- New version:
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#familiar
- Status:
- Critical features and important information for the user is easy to find, such that:
- Allocated to: Susann
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#critical
- All information is easy to find (AAA)
- Allocated to:
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#allinformation
- When there is a barrier between the content and the user that requires additional abilities an alternative is provided that does not require additional abilities.
- Allocated to: Mike Pluke
- New version: broken into two
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#barrier
- Status: rewording of first sc requested
- Provide mechanisms that help the user focus and maintain or restore context if the context is lost.
- Allocated to: Jannina
- New version:
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#focus
- The success or failure of every action should be clearly indicated to the user and visual rapid feedback should be available. Spoken feedback should be a user selectable option.
- Allocated to: Kurt
- New version: https://rawgit.com/w3c/coga/master/extension/rapid-and-direct-feedback.html
- Original version: https://rawgit.com/w3c/coga/master/extension/index.html#the-success-or-failure-of-every-action-should-be-clearly-indicated-to-the-user-and-visual-rapid-feedback-should-be-available.-spoken-feedback-should-be-a-user-selectable-option.x
Status: suggested changes need to be integrated
- Known standardized APIs for tools that help the user understand and use the content are supported.
- Allocated to: Kurt (reassigned)
- New version:
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#api
- Provided content and information that help users understand the content
- Allocated to: Neil
- New version:
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#provided content
- Prevent the user from making errors
- Allocated to: Thaddeus
- New version: note that this has been split into 3
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#prevent
- Support is provided that help users check their task and repair their work
- Allocated to: Thaddeus
- New version:
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#support
- Humen help is provided
- Allocated to:
- New version:
- Original version: not yet done
- Items where WCAG 2.0 SC levels should be changed - note this is more then one!
- Allocated to:
- New version:
- Original version:https://rawgit.com/w3c/coga/master/extension/index.html#changedlevels