Copyright ©2002 W3C ®( MIT , INRIA , Keio), All Rights Reserved. W3C liability , trademark , document use and software licensing rules apply.
This specification provides guidelines for Web authoring tool developers. Its purpose is two-fold: to assist developers in designing authoring tools that produce accessible Web content and to assist developers in creating an accessible authoring interface.
Authoring tools can enable, encourage, and assist users ("authors") in the creation of accessible Web content through prompts, alerts, checking and repair functions, help files and automated tools. It is just as important that all people be are able to author content as it is for all people to have access to it. The tools used to create this information, therefore, must therefore also be accessible themselves. Adoption Implementation of these guidelines will contribute to the proliferation of Web content that can be read by a broader range of readers and authoring tools that can be used by a broader range of authors in a wider range of contexts with more devices.
This document is part of a series of accessibility documents published by the W3C Web Accessibility Initiative (WAI).
This section describes the status of this document at the time of its publication. Other documents may supersede this document. The latest status of this document series is maintained at the W3C.
This is a Public Working Draft of a document which will supersede the W3C Recommendation Authoring Tool Accessibility Guidelines 1.0 [ATAG10]. It has been made available for review by W3C Members and other interested parties, in accordance with W3C Process. It is not endorsed by the W3C or its Members. It is inappropriate to refer to this document other than as a "work in progress".
This document has been produced by the Authoring Tool Accessibility Guidelines Working Group (AUWG) as part of the Web Accessibility Initiative (WAI). The goals of the Working Group are discussed in the AUWG charter. A list of current W3C Recommendations and other technical documents including Working Drafts and Notes can be found at http://www.w3.org/TR/. The AUWG is part of the WAI Technical Activity.
This draft refers to the Web Content Accessibility Guidelines (WCAG) for specification of accessible content and refers non-normatively to the Techniques for Authoring Tool Accessibility [ATAG20-TECHS].
The AUWG expects the ATAG 2.0 to be backwards-compatible with ATAG 1.0, or at most to make only minor changes in requirements. Before this document reaches last call, the Working Group will publish a detailed analysis of the differences in requirements.
The working group maintains an ATAG 2.0 Issues List and a log of changes between successive Working Drafts.
Please send comments about this document to the public mailing list: w3c-wai-au@w3.org (public archives). Please note that this document may contain typographical errors. It was published as soon as possible since review of the content itself is important, although noting typographical errors is also helpful.
For information about the current activities of the working group, please refer to the AUWG home page. This page includes an explanation of the inter-relation of each document as well as minutes and previous drafts.
In these guidelines, the term "authoring tool" refers to the wide range of software used for creating Web content, including:
Everyone should have the ability to create and access Web content.
Authoring tools are pivotal in achieving this principle. The accessibility of authoring tools determines who can create Web content and the output of authoring tools determines who can access Web content.
***I wonder if we should be so precise about the word 'content'. I find myself having to broaden it to include services and spend a lot of time trying different words like resources,....I know we ar working on WCAG but the Web is getting to be a more interactive place, and needs to in the future...
The guidelines set forth in this document will benefit people with and without disabilities?? can this be changed? it is pretty clumsy.. This includes people who need to use their eyes for another task and are unable to view a screen or and people in environments where the use of sound is not practical or and people who use small mobile devices with small screens, no keyboard, or no mouse.(I think that this is about 'includes ..this and this and this...'?)
The guidelines reflect promote the following goals:
**I think that we should be up-front about what we are aiming for - the subjunctive tense is very polite but maybe not necessary???
The accessibility of authoring tools is defined primarily by existing specifications for accessible software. The accessibility of authoring tool output is defined by the Web Content Accessibility Guidelines (WCAG).
This document contains four guidelines that reflect the goals of accessible authoring tool design:
**I think the integration you want is achieved by having this introduction. When people are trying to implement the guidelines, I think it helps a lot if they can work on bits - so I am not sure there is the problem you have suggested.
Each guideline includes:
Each checkpoint is intended to be sufficiently specific enough that it can be verified to be verifiable, while being sufficiently general to allow developers the freedom to use the most appropriate strategies to satisfy it. The checkpoints specify requirements for meeting the guidelines. Each checkpoint includes:
A separate document, entitled "Techniques for Authoring Tool Accessibility Guidelines 2.0" [ATAG20-TECHS], provides suggestions and examples of how to achieve the recommendations in this document. Another document [ATAG20-CHECKLIST] lists all checkpoints, ordered by priority, for convenient reference.
Each checkpoint in the specification has been assigned one of the following priority levels to reflect indicate the importance of the checkpoint in satisfying the guidelines:
Note: The choice of priority level for each checkpoint has been chosen is based on the assumption that the author is a competent, but not necessarily expert, user of the authoring tool, and that the author has little or no knowledge of accessibility. For example, the author is not expected to have read all of the documentation, but is expected to know how to turn to the documentation for assistance.
An ATAG conformance claim for an authoring tool must indicate which of the following conformance levels has been met:
For the purposes of ATAG 2.0 conformance claims, tools may be bundled together (e.g. a markup editor and a evaluation and repair tool or a multimedia editor with a custom plug-in), however, this has two important consequences:
Conformance Icons: There are currently no conformance icons available for this draft specification. If it becomes a recommendation, it is expected that there will be conformance icons like those available for ATAG 1.0.
From the standpoint of accessibility, Web authoring is a process that may involve one or more tools in parallel or in sequence. In order to ensure that the Web content produced as a result of a Web authoring process is accessible, developers and purchasers should choose tools that are either ATAG 2.0 conformant or ATAG 2.0-"Friendly". ATAG-"Friendly" tools are tools which, although they do not conform with ATAG, are also very unlikely to degrade the accessibility of Web content. For example, an ATAG-friendly tool which might converts the URI locations in a Web page from absolute to relative prior to publishing.
In some cases, strategic ordering of the tools in a Web authoring process may increase the likelihood of producing accessible content. For example, a markup editor that does not conform to ATAG might be used before an ATAG conformant evaluation and repair tool. While this is, of course, preferable to not addressing accessibility at all, the original markup tool is still considered ATAG non-conformant. Considering the markup editor and evaluation and repair tool together is possible, but due to the low likelihood of proper integration between the tools, the result is unlikely to be a high -level ATAG conformance level.
The An authoring tool is a software program with standard user interface elements and as such must be designed according to relevant user interface accessibility guidelines. When custom interface components are created, it is essential that they be accessible through the standard access mechanisms for the relevant platform so that assistive technologies can be used with them.
Some additional user interface design considerations apply specifically to Web authoring tools. For instance, authoring tools must ensure that the author can edit (in an editing view) using one set of stylistic preferences and publish using different styles. Authors with low vision may need large text when editing but want to publish with a smaller default text size. The style preferences of the editing view must not affect the markup of the published document.
Authoring tools must also ensure that the author can navigate a document efficiently while editing, regardless of disability. Authors who use screen readers, refreshable Braille displays, or screen magnifiers can make limited use (if any at all) of graphical artifacts that communicate the structure of the document and act as signposts when traversing it. Authors who cannot use a mouse (especially e.g., people with physical disabilities or who are blind) must use the slow and tiring process of moving one step at a time through the document to access the desired content, unless more efficient navigation methods are available. Authoring tools should therefore provide an editing view that conveys a sense of the overall structure and allows structured navigation.
Note: Documentation, help files, and installation are part of the software and need to be available in an accessible form.
Rationale: If the authoring tool interface does not follow these conventions, the author who depends upon the techniques associated with the conventions is not likely to be able to use the tool.
Techniques: Implementation Techniques for Checkpoint 1.1, Evaluation Techniques for Checkpoint 1.1
Success Criteria:
This checkpoint requires all aspects of the authoring interface to be
accessible to the author. This wide scope means
that the checkpoint applies to the implementation of all the
other checkpoints
in this guidelines document. The techniques for this checkpoint
include references to checklists and guidelines for a number
of platforms
and to general guidelines for accessible
applications. In many cases several sets of standards will be
applicable.
[@@issue 7 there is no
minimum requirement
here]
**'This wide scope means that the checkpoint applies to the implementation of all the other checkpoints in this guidelines document.' - I don't agree with this being there - it reads like a joke on the guidelines authors!
Note This checkpoint is a special case of checkpoint 1.1 that is especially important to authoring tools.
Techniques: Implementation Techniques for Checkpoint 1.2, Evaluation Techniques for Checkpoint 1.2
Success Criteria: provide at least one accessible way to edit every element and object property supported by the tool.
Note This checkpoint is a special case of checkpoint 1.1 that is especially important to authoring tools.
Techniques: Implementation Techniques for Checkpoint 1.3, Evaluation Techniques for Checkpoint 1.3
Success Criteria: the checkpoint requires that the author be able to copy, cut or paste an element and its content at any level of the document tree hierarchy and retain the content's hierarchical level.
Note: This checkpoint applies primarily to WYSIWYG markup editing tools and requires that the author be able to view the content, as it is being authored, in a way that differs from the presumed default appearance of the rendered published? content.
Techniques: Implementation Techniques for Checkpoint 1.4, Evaluation Techniques for Checkpoint 1.4
Success Criteria: there must be some mechanism for changing the document display independently of the document markup.
There are a number of ways that this can be achieved, including supporting operating environment display preferences and allowing the author to specify an editing style sheet that is different from those included with the published document. In addition, there must be some means by which textual alternatives can be displayed to the author in place of non-text elements. [@@Issue 8 - need to clean this paragraph up - some is techniques, plus wording and some is useful for the checkpoint]
Although there are many ways this can be achieved, there must be one way for the author to change the display of the content during authoring that is independent of the document mark-up.The author must be able to access the text alternatives in the place of any non-text elements.
Rationale: simplify navigation for the author.
Techniques: Implementation Techniques for Checkpoint 1.5, Evaluation Techniques for Checkpoint 1.5
Success Criteria: the author should be able to move from element to element. [@@Issue 9: is this actually what we need?]
The author must be able to access the means to navigate the content via the document structure.
Rationale: Search functions facilitate author navigation of content as it is being authored. Most markup editing tools will already provide a search function, other authoring tools (i.e. multimedia editors, etc.) may not.The purpose of this checkpoint is to encourage authoring tool developers to include search functions into their tools in order to facilitate navigation of the content as it is authored. This search capability may be as simple as a string matching "find" function in a basic text editor or as complex as search functions that take advantage of the structure (elements, attributes, etc.) inherent in marked-up content.
As this is a checkpoint within Guideline 7 (Ensure that the Authoring Tool is Accessible to Authors with Disabilities) there is one other implicit requirement: that is that the search function must able to move the editing focus immediately to the occurrences that it finds (one at a time s requested by the author).
Techniques: Implementation Techniques for Checkpoint 1.6, Evaluation Techniques for Checkpoint 1.6
Success Criteria:
The purpose of this checkpoint is to encourage authoring tool developers to include search functions into their tools in order to facilitate navigation of the content as it is authored. This search capability may be as simple as a string matching "find" function in a basic text editor or as complex as search functions that take advantage of the structure (elements, attributes, etc.) inherent in marked-up content.
As this is a checkpoint within
Guideline 7 (Ensure
that the Authoring Tool is Accessible to Authors with
Disabilities) there
is one other implicit requirement: that is that the search
function must
able to move the editing focus immediately to the occurrences that it
finds (one at a time s requested by the author). The
author must be able to access one way to search the content
being authored
and quickly move the editing focus to the
occurrences.
A tool that merely highlights all the found occurrences simultaneously
without allowing the author to quickly move the editing focus
to the occurrences
is not helpful as a document navigation function.
The tool should allow basic text search with a choice of skipping or including markup.
The most basic determinant of the accessibility of Web content is the degree to which the authoring tool that produced it gives priority was designed with attention to markup validity and accessibility. Tools that generate and preserve high quality markup are well prepared to meet the other guidelines.
***ummm. This worries me a little.
Conformance with standards promotes interoperability and accessibility by making it easier to create specialized user agents that address the needs of users with disabilities. In particular, many assistive technologies used with browsers and multimedia players are only able to provide access to Web documents that use valid markup. Therefore, the production of valid markup is an essential aspect of the accessibility compliance of an authoring tool accessibility.
Where applicable use W3C Recommendations, which have been reviewed to ensure accessibility and interoperability and which are relied upon by assistive tool developers. If there are no applicable W3C Recommendations, use a published standard that enables accessibility.
Rationale: Many of the W3C language recommendations have been designed with accessibility as a goal. In addition, the W3C has published Nnotes for some of its most popular language recommendations, describing best use practices. As a result, building accessibility-aware authoring tools for W3C languages should be easier than for other language formats that lack these supports.
Techniques: Implementation Techniques for Checkpoint 2.1, Evaluation Techniques for Checkpoint 2.1
Success Criteria:
Rationale: Following language specifications is the most basic requirement for accessible content production. When content is valid, it is easier to check and correct accessibility errors and user agents are better able to render the content properly and personalize the content to the needs of individual users' devices.
Techniques: Implementation Techniques for Checkpoint 2.2, Evaluation Techniques for Checkpoint 2.2
Success Criteria:
If the tool automatically generates markup, many authors will be unaware of the accessibility status of the final content unless they expend extra effort to review it and make appropriate corrections by hand. Since many authors are unfamiliar with accessibility, authoring tools are responsible for automatically generating accessible markup, and where appropriate, for guiding the author in producing accessible content.
Many applications feature the ability to convert documents from other formats (e.g., Rich Text Format) into a markup format specifically intended for the Web such as HTML. Markup changes may also be made to facilitate efficient editing and manipulation. It is essential that these processes do not introduce inaccessible markup or remove other content intended to increase accessibility, particularly when a tool hides the markup changes from the author's view.
Rationale: The most basic support for accessibility is ensuring that it is at least possible for the author to produce accessible content. Without this posssibility, further efforts are futile. The simplest way to assure this possibility exists is to allow authoring "by hand", so that well-informed authors can work around any accessibility shortcomings in the automatic generation of markup. However, t Tools that only generate markup automatically must ensure the accessibility of all generated markup in order to meet this requirement.
Techniques: Implementation Techniques for Checkpoint 2.3, Evaluation Techniques for Checkpoint 2.3
Success Criteria:
If authoring "by hand" is not provided then:
Rationale: Once the author has made the effort to add accessible content, either manually or with the aid of the authoring tool, it would be absurd highly inconvenient for the authoring tool not to take care with fail to preserve that content when converting (i.e. taking content encoded in one markup language and re-encoding it in another) or transforming it (i.e. modifying the encoding of content without changing the markup language). Note: Differences in grammatical richness must be taken into account, between markup languages in the case of conversions, and between markup entities in the case of conversions transformations??.
Techniques: Implementation Techniques for Checkpoint 2.4, Evaluation Techniques for Checkpoint 2.4
Success Criteria:
Rationale: Authoring tools that automatically generate content that does not conform to WCAG are an obvious source of accessibility problems. If the tool includes checking and correction features tools, problems result in inconvenieence as the author must use them or others to correct errors which were completely under the control of the tool. If the tool does not include checking and correction tools, the result is almost certainly WCAG non-conformant documents.
Techniques: Implementation Techniques for Checkpoint 2.5, Evaluation Techniques for Checkpoint 2.5
Success Criteria:
Rationale: Pre-authored content is included with authoring tools for the convenience of the author. Including WCAG conformant pre-authored content increases that convenience by (1) ensuring that authors can use any of the content without concern for the accessibility implications and (2) prevents each individual author from having to compose their own version of alternative content when this task could have been done just once by the distributor. Pre-authored content may include (e.g. accessible markup and content for templates, alt text, long descriptions for images, captions, auditory descriptions and collated text transcriptions for multimedia objects, and accessible design and functional alternatives for applets and scripts, etc.) increases that convenience by (1) ensuring that authors can use any of the content without concern for the accessibility implications and (2) prevents each individual author from having to compose their own version of alternative content when this task could have been done just once by the distributor.
Techniques: Implementation Techniques for Checkpoint 2.6, Evaluation Techniques for Checkpoint 2.6
Success Criteria:
Rationale: Markup that is not recognized by an authoring tool may have been added to enhance accessibility.
Techniques: Implementation Techniques for Checkpoint 2.7, Evaluation Techniques for Checkpoint 2.7
Success Criteria:
It is acceptable for a tool to refuse to open a document that contains markup that it cannot process, but that the author chooses to retain.
**note change of numbering...
While ensuring the accessibility of automated output provides a solid foundation for accessible content, the authors often will likely act in ways that confound this ideosyncratically. Therefore, it is especially important that the authoring tool support the author by guiding them in matters that involve an element of human judgment or creativity, providing automated or semi-automated checking and correction facilities and by providing high quality accessibility documentation.
Well-structured information and equivalent alternative information are cornerstones of accessible design, allowing information to be presented in a way most appropriate for the needs of the user without constraining the creativity of the author. However, pProducing equivalent information, such as text alternatives for images and auditory descriptions of video, can be one of the most challenging for authors aspects of Web design, and authoring tool developers should attempt to facilitate and automate the mechanics of this process. For example, prompting authors to include equivalent alternative information such as text equivalents, captions, and auditory descriptions at appropriate times can significantly help greatly ease the burden for authors. (**Jan, you probably note that I am turning passive or defensive expressions into active, positive ones. I think they are better for readers.) Where such information can be mechanically determined and offered as a choice for the author (e.g., the function of icons in an automatically-generated navigation bar, or expansion of acronyms from a dictionary), the tool can assist the author. At the same time, the tool can reinforce the need for such information and the author's role in ensuring that it is used appropriately in each instance.
Rationale: While structuring content and separating content from presentation is important from an accessibility standpoint, it can prove difficult to those used to using the 'look' of the content to convey meaning. with contentis often counter-intuitive to accustumed to implicitly encoding the context of information into its visual "look". Therefore, sSupporting the author in this aspect of markup production is crucial. Note: Some checkpoints in Web Content Accessibility Guidelines 2.0 [ WCAG20] do not apply.
Techniques: Implementation Techniques for Checkpoint 3.2, Evaluation Techniques for Checkpoint 3.2
Success Criteria:
Rationale: Content that has been created in association with its presentation may be difficult to separate from its presentation in order for it to be presented in an accessible way.Tools that separate the content from its presentation features can assist the author in such circumsances.
Techniques: Implementation Techniques for Checkpoint ???, Evaluation Techniques for Checkpoint ???
Success Criteria:
Rationale:
Techniques:
Success Criteria:
Rationale: Appropriate prompting This checkpoint is intended to result in typical tool users providing equivalent alternatives for all non-text elements (including alternate text, captions, auditory descriptions, collated text transcripts for video, etc.). Different tools will accomplish this goal in ways appropriate to their product, processes and their users.
Techniques: Implementation Techniques for Checkpoint 3.1, Evaluation Techniques for Checkpoint 3.1
Success Criteria:
Rationale: Improperly generated alternatives can interfere with accessibility checking.
Techniques: Implementation Techniques for Checkpoint 3.3, Evaluation Techniques for Checkpoint 3.3
Success Criteria:
Rationale: Simplifying the initial production and later reuse of alternative equivalents will encourage authors to use them more frequently. In addition, such a alternative equivalent management system will facilitate meeting the requirements of Checkpoint 3.3.
Techniques: Implementation Techniques for Checkpoint 3.4, Evaluation Techniques for Checkpoint 3.4
Success Criteria:
Authoring tool support for the creation of accessible Web content should account for different authoring styles. Authors who can choose how to configure the tool's accessibility features to support their regular work patterns are more likely to feel comfortable with their use of the tool and be receptive to interventions from the tool.accept accessible authoring practices (see guideline 5). For example, some authors may prefer to be alerted to accessibility problems when they occur, whereas others may prefer to perform a check at the end of an editing session. This choice is analogous to that offered in programming environments that allow users to decide whether to check for correct code during editing or at compilation.
Note: Validation of markup is an essential aspect of checking the accessibility of content.
Rationale: provide the author with a utility that helps check documents for accessibility problems.
Techniques: Techniques for checkpoint 3.5, Evaluation Techniques for Checkpoint 3.5.
Success Criteria:
At minimum (required basic functionality): this utility must provide at least one, automated or manual, check for each WCAG 2.0 [WCAG20] checkpoint (of relevant priority). When this utility runs it must always check those questions pertaining to "In General" WCAG 2.0 checkpoints, but only those "conditional" WCAG 2.0 checkpoints that have their conditions fulfilled by the document.
Rationale: once accessibility problems have been found, help the authors may need help to correct them properly.
Techniques: Techniques for checkpoint 3.6, Evaluation Techniques for Checkpoint 3.6
Success Criteria:, provide context-sensitive help with the accessibility checking required by checkpoint 3.5.
Rationale: encourage authoring tools to notify authors of accessibility problems in a coherent way.
Techniques: Techniques for checkpoint 3.7, Evaluation Techniques for Checkpoint 3.7.
Success Criteria:
Web authors may not be familiar with accessibility issues that arise when creating Web content. Therefore, help and other supplied documentation must include explanations of accessibility problems, and should demonstrate solutions with examples.
Rationale: As with any feature, documentation of all the accessibility related features of the tool (dialog boxes, utility, code views, etc.) will facilitate authors in finding and using them, effectively.
Techniques: Techniques for checkpoint 3.8, Evaluation Techniques for Checkpoint 3.8.
Success Criteria:
Rationale: Authors will be more likely to effectively use the accessibility features of the tool effectively if a they have a workflow strategy for integrating the new accessibility related tasks inot into the Web content authoring that thery already perform.
Techniques: Techniques for checkpoint 3.9, Evaluation Techniques for Checkpoint 3.9
Success Criteria:
When a new feature is added to an existing software tool without proper integration, the result is often an obvious discontinuity. Differing color schemes, fonts, interaction styles, and even software stability can be factors affecting author acceptance of the new feature. In addition, the relative prominence of different ways to accomplish the same task can influence which one the author chooses. Therefore, it is important that creating accessible content be a natural process when using an authoring tool.
Rationale: The user must be easily able to turn on accessibility support functionality.
Techniques: Implementation Techniques for Checkpoint 4.1, Evaluation Techniques for Checkpoint 4.1
See Also: ATAG Checkpoints 3.1, 3.2, 3.5 and 3.6.
Success Criteria:
Rationale: For accessibility-related functionality to be accepted by authors, it must be integrated as seamlessly as possible.^^why the bold???
Techniques: Implementation Techniques for Checkpoint 4.2, Evaluation Techniques for Checkpoint 4.2
Success Criteria:
Rationale: User interfaces can increase the probability that authors will use accessible authoring practices, even when less accessible alternatives are provided by the tool for reasons of completeness.
Techniques: Implementation Techniques for Checkpoint 4.3, Evaluation Techniques for Checkpoint 4.3
Success Criteria:
Rationale: This checkpoint promotes the production of accessible content by implicitly demonstrating to the author that all content, regardless of purpose, should comply with the WCAG guidelines.
Techniques: Implementation Techniques for Checkpoint 4.4, Evaluation Techniques for Checkpoint 4.4
Success Criteria:
"alt"
,
"title"
,
and "longdesc"
attributes in HTML). IMG
or DL
), the
values of its
attributes, and information associated by means of a
style sheet.
In a database, properties of a particular element may include values of
the entry, and acceptable data types for that entry.BLOCKQUOTE
element in HTML [HTML4]to achieve an
indentation visual
layout effect. Structural markup should be used correctly to communicate
the roles of the elements of the content and presentation
markup should be used separately to control the presentation
and layout.Many thanks to the following people who have contributed through review and comment: Giorgio Brajnik, Daniel Dardailler, Katie Haritos-Shea, Phill Jenkins, Len Kasday, Marjolein Katsma, William Loughborough, Matthias Müller-Prove, Graham Oliver, Chris Ridpath, Gregory Rosmaita, Heather Swayne, Carlos Velasco.
This document would not have been possible without the work of those who contributed to The Authoring Tool Accessibility Guidelines 1.0
For the latest version of any W3C specification please consult the list of W3C Technical Reports at http://www.w3.org/TR.