Authoring Tool Accessibility Guidelines 1.0 (working draft)

W3C Working Draft 17-June-1999

This version:
Latest version:
Previous version:
Jutta Treviranus <jutta.treviranus@utoronto.ca>
Jan Richards <jan.richards@utoronto.ca>
Ian Jacobs <ij@w3.org>
Charles McCathieNevile <charles@w3.org>


This document provides guidelines for Web authoring tool developers. Its purpose is two-fold: to assist developers in designing authoring tools that generate accessible Web content and to assist developers in creating an accessible authoring interface.

Accessible Web content is achieved by encouraging authoring tool users ("authors") to create accessible Web content through mechanisms such as prompts, alerts, checking and repair functions, help files and automated tools. It is equally important that all people can be the authors of Web content, rather than merely recipients. It is therefore of critical importance that the tools used to create this content are themselves accessible. Adoption of these guidelines will result in the proliferation of Web pages that can be read by a broader range of readers and in authoring tools that can be used by a broader range of authors.

This document is part of a series of accessibility documents published by the W3C Web Accessibility Initiative.

Status of this document

This is a Working Draft of the Authoring Tool Accessibility Guidelines. It is a draft document and may be updated, replaced or rendered obsolete by other documents at any time. It is inappropriate to use W3C Working Drafts as reference material or to cite them as other than "work in progress". This is work in progress and does not imply endorsement by either W3C or members of the WAI Authoring Tool (AU) Working Group.

Guideline 2.1 is identified by the working group as a specific area for review in this draft, although comment is sought on the entire guidelines and techniques documents.

This draft follows the Working Group's telephone meeting on 16 June 1999. With possible minor review, this document is expected to be published for review by the WAI Interest Group prior to publication as a public working draft. A log of changes between successive working drafts is available.

The Techniques given in the linked "Techniques" document are intended to be informative only. They will not be present in the "normative" version, although there will still be a link to the Techniques document. This will enable them to be updated more easily than the Guidelines themselves.

The goals of the WAI AU Working Group are discussed in the WAI AU charter.

Please send comments about this document to the public mailing list: w3c-wai-au@w3.org, archived at http://lists.w3.org/Archives/Public/w3c-wai-au

A list of the current AU Working Group members is available.

Table of Contents

1 Introduction

The various authoring tools used to generate Web content play a critical role in determining the form and accessibility of the Web. Authoring tools are used to automate the mechanical tasks that are part of producing Web pages. The power of this automation can enhance the accessibility of the Web if it is used to ensure that the code produced promotes accessibility, and frees the author to concentrate on the higher level problems of overall design, content, description, etc. It is imperative that authoring tools generate content that is accessible, and that they are accessible themselves, to allow people to be consumers and producers of Web content on an equal footing, regardless of disability.

The accessibility of authoring tools encompasses some general principles of software accessibility, and some features which are specific requirements for authoring. The accessibility of the content produced depends on the ability of the tool to be used in producing accessible markup, and on the user interface of the tool enabling, informing, and encouraging the use of accessible markup authoring practices. These Guidelines refer extensively to the Web Content Accessibility Guidelines, which details accessibility requirements for markup itself, and include checkpoints which are basic requirements for the accessibility of the tool and its output. In addition, there are guidelines and checkpoints which are uniquely relevant to the role authoring tools play in guiding the author to produce accessible content.

1.1 Scope of these Guidelines

These guidelines are intended to be used by developers of all tools used to produce content for the Web. These include:

1.2 Guidelines, Checkpoints, and Techniques

The guidelines documents have been organized to address readers seeking abstract principles of accessible authoring tool design and readers seeking concrete solutions. The guidelines documents define three terms for different levels of abstraction:

A guideline is a general principle of accessible authoring tool design. A guideline addresses the question "What accessibility issues should I be aware of?"
A checkpoint is a specific way of satisfying one or more guidelines. While checkpoints describe verifiable actions that may be carried out by the authoring tool developer, implementation details are described elsewhere. A checkpoint answers the question "What must/should/may I do to make an authoring tool (and the content it produces) accessible?"
A technique is an example of, or further information about implementation of a checkpoint. A technique answers the question "How might I implement that in an authoring tool?"

1.3 Checkpoint priorities

[Editors' note: These definitions are to be further refined]

There are three goals:

[Priority 1]
Essential to meeting those goals
[Priority 2]
Important to meeting those goals
[Priority 3]
Beneficial to meeting those goals

1.4 Conformance to these Guidelines

This section defines three levels of conformance to this document:

Note. Conformance levels are spelled out in text so they may be understood when rendered to speech.

Claims of conformance to this document must use one of the following two forms.

Form 1: Specify:

Example of Form 1: "MyAuthoringTool version 2.3 conforms to W3C's "Authoring Tool Accessibility Guidelines 1.0 (working draft)", available at http://www.w3.org/WAI/AU/WAI-AUTOOLS-19990617, level Double-A."

Form 2: Include, on each statement of conformance, one of three icons provided by W3C and link the icon to the appropriate W3C explanation of the claim.

[Editors' note: In the event this document becomes a Recommendation, by that date WAI will provide a set of three icons, for "A", "Double-A", or "Triple-A" conformance levels of "Authoring Tool Accessibility Guidelines 1.0 (working draft)", together with a stable URI to the W3C Web site for linking the icons to the W3C explanation of conformance claims.]

2 Guidelines

Guideline 2.1 Ensure that the Authoring Tool is Accessible to Authors with Disabilities

[Editors' Note: this guideline was three guidelines entitled Follow principles of accessible design, ensure independence of authoring and publishing environments, provide accessible navigation]

The authoring tool is a software program with standard user interface elements and as such should follow relevant user interface accessibility guidelines.

The author may need a different presentation to edit the Web content than the one they wish ultimately to be displayed. This implies display preferences that do not manifest themselves in the ultimate markup or style declarations.

Authoring Web content requires editing a potentially large and complex document. In order to edit a document the author must be able to locate and select specific blocks of text, efficiently traverse the document and quickly find and mark insertion points. Authors who use screen readers, refreshable braille displays, or screen magnifiers can make limited use (if at all) of visual artifacts that communicate the structure of the document and act as sign posts when traversing the document. There are strategies that make it easier to navigate and manipulate a marked up document . A compressed view of the document allows the author to both get a good sense of the overall structure and to navigate that structure more easily.


2.1.1: [Priority 1]
Use all applicable operating system and accessibility standards and conventions.
2.1.2: [Priority 1]
The author must be able to change the editing view without changing the presentational markup defined for the document currently being edited.
2.1.3: [Priority 1]
Allow the author to display an editable equivalent for each element, object, and property which is available for editing.
2.1.4: [Priority 1]
Enable navigation and editing via the structure of the document.
2.1.5: [Priority 2]
Enable editing of the structure of the document.

Guideline 2.2 Generate standard markup

The first step towards producing accessible content is conformance with standards, which promotes interoperability.


2.2.1: [Priority 2]
Use applicable W3C Recommendations.
2.2.2: [Priority 1]
Extensions to W3C Recommendations must not make content inaccessible.

Guideline 2.3 Support accessible authoring practices

Methods for ensuring accessible markup vary with different markup languages. If markup is automatically generated, many authors will be unaware of the accessibility status of the final product unless they expend extra effort to make appropriate corrections by hand. Since many authors are unfamiliar with accessibility, these problems are likely to remain.

Many applications feature the ability to convert documents from other formats (e.g., Rich Text Format) into a markup format, such as HTML. Markup changes may also be made to facilitate efficient editing and manipulation. These processes are usually hidden from the user's view and may create inaccessible content or cause inaccessible content to be produced.


2.3.1: [Priority 1]
Implement all accessible authoring practices that have been defined for the markup language(s) supported by the tool.
2.3.2: [Priority 1]
Produce content that is conformant to the W3C's Web Content Accessibility Guidelines [WAI-WEBCONTENT]. [Priority 1 for level-A conformance, Priority 2 for double-A conformance, Priority 3 for triple-A conformance]
2.3.3: [Priority 1]
Ensure that templates to be inserted in the document are conformant to W3C Web Content Accessibility Guidelines [WAI-WEBCONTENT]. [Priority 1 for level-A conformance, Priority 2 for double-A conformance, Priority 3 for triple-A conformance]
2.3.4: [Priority 1]
Preserve all accessibility content during transformations and conversions.

Guideline 2.4 Ensure that no accessibility content is missing

Textual equivalents, including "alt-text", long descriptions, video captions, and transcripts are absolutely necessary for the accessibility of all images, applets, video, and audio files. However, the task of producing these equivalents is probably the most time-consuming accessibility recommendation made to the author.

The authoring tool can provide various mechanisms to assist the author in generating textual equivalents while ensuring that the author can determine whether the textual equivalent accurately reflects the information conveyed by the multimedia object.

Including professionally written descriptions for all multimedia files (e.g., clip-art) packaged with the tool will:

This will lead to an increase in the average quality of descriptions used.


2.4.1: [Priority 1]
Prompt the author to provide alternative content (e.g., captions, descriptive video). (Priority 1 for alternative content which is [Web-Content-Priority-1], Priority 2 for alternative content which is [Web-Content-Priority-2], Priority 3 for alternative content which is [Web-Content-Priority-3])
2.4.2: [Priority 1]
Prompt the author for all missing structural information (e.g., language changes, table headers). (Priority 1 for structural information which is [Web-Content-Priority-1], Priority 2 for structural information which is [Web-Content-Priority-2], Priority 3 for structural information which is [Web-Content-Priority-3])
2.4.3: [Priority 1]
Allow the author to edit all alternative content and structural information.
2.4.4: [Priority 2]
Provide pre-written alternative content for all multimedia files packaged with the authoring tool.
2.4.5: [Priority 3]
Provide a mechanism to manage alternative content for multimedia objects, which retains and offers for editing pre-written or previously linked alternative content.
2.4.6: [Priority 1]
Do not insert automatically generated (e.g., the filename) or place-holder (e.g., "image") equivalent text, except in cases where human-authored text has been written for an object whose function is known with certainty.

Techniques for this guideline

Guideline 2.5 Integrate accessibility solutions into the overall "look and feel"

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 application stability can be factors affecting user acceptance of the new feature.


2.5.1: [Priority 2]
Ensure that the highest-priority accessible authoring practices are the most visible and easily initiated by the author. Highlight the most accessible solutions when presenting choices for the author.
2.5.2: [Priority 1]
Make generation of accessible content a naturally integrated part of the authoring process

Guideline 2.6 Provide methods of checking and correcting inaccessible content

Many authoring tools allow authors to create documents with little or no knowledge about the underlying markup. To ensure accessibility, authoring tools must be designed so that they may automatically identify inaccessible content, and enable its correction even when the markup itself is hidden from the author.

In supporting the creation of accessible Web content, authoring tools must take into account the differing authoring styles of their users. Some users may prefer to be alerted to problems when they occur, whereas others may prefer to perform a check after the document is completed. This is analogous to programming environments that allow users to decide whether to check for correct code during editing or at compile time.

Note that validity is an accessibility requirement, particularly for assistive technologies.


2.6.1: [Priority 1]
Check for and alert the author to accessibility problems. (Priority 1 for accessibility problems which are [Web-Content-Priority-1], Priority 2 for accessibility problems which are [Web-Content-Priority-2], Priority 3 for accessibility problems which are [Web-Content-Priority-3])
2.6.2: [Priority 2]
Allow users to control both the nature and timing of accessibility alerts.
2.6.3: [Priority 1]
Assist authors in correcting accessibility problems. (Priority 1 for accessibility problems which are [Web-Content-Priority-1], Priority 2 for accessibility problems which are [Web-Content-Priority-2], Priority 3 for accessibility problems which are [Web-Content-Priority-3])
2.6.4: [Priority 2]
When removing unrecognized markup, alert the author (according to a configurable schedule)
2.6.5: [Priority 3]
Provide the author with a summary of the accessibility status on a configurable schedule.
2.6.6: [Priority 3]
Allow the author to perform tag transformations. For example, to transform visually formatted elements to structure elements, or tables to lists.

Techniques for this guideline:

Guideline 2.7 Promote accessibility in help and documentation

The issues surrounding Web accessibility are often unknown to Web authors. Help and documentation should explain accessibility problems and solutions, with examples.


2.7.1: [Priority 1]
Integrate accessible authoring practices in all applicable help topics.
2.7.2: [Priority 1]
Explain the use of accessible authoring practices supported by the authoring tool.
2.7.3: [Priority 1]
Examples must not use inaccessible markup.
2.7.4: [Priority 3]
Emphasize the universal benefit of accessible design.

3 Terms and Definitions

[Editors' note: This section will be reviewed by the group, and is expected to be updated in future drafts]

Integrated Author Guidance and Prompting

Interface mechanisms such as dialogs, menus, toolbars, and palettes can be structured so that markup or elements that are accessible are given as the first and easiest choice.

Prompts and Alerts

Prompts can be used to encourage authors to provide information needed to make the content accessible (such as alternative textual representations). Prompts are simple requests for information before a markup structure has been finalized. For example, an "alt-text" entry field prominently displayed in an image insertion dialog would constitute a prompt. Prompts are relatively unintrusive and address a problem before it has been committed. However, once the user has ignored the prompt, its message is unavailable.

Alerts warn the author that there are problems that need to be addressed. The art of attracting users' attention is a tricky issue. The way in which users are alerted, prompted, or warned will influence their view of the tool as well as their opinion of accessible authoring.

User Configurable Schedule
A user configurable schedule allows the user to determine the type of prompts and alerts which are used, including when they are presented.
Prompts are simple requests for information before a markup structure has been finalized.
Alert Tools
Alerts notify the author of something. They may or may not require author response.

Markup Editing Tools and Functions

Authoring Tool
As used in this document, an Authoring Tool is any piece of software which is used to generate content for publishing on the Web. See also section 1.3 Scope of these guidelines.
A process whereby one object is changed, according to a discrete set of rules, into another, equivalent, object. This includes any application or application feature that allows content which is marked up in a particular markup language to be transformed into another markup language, such as software which allows the author to change the DTD defined for the original document to another DTD. It also describes the substitution of textual equivalents for graphical or visually defined elements and objects, and the conversion from one element type to another within a document.

Documents, Elements, and Attributes

A document is a series of elements that are defined by a language (e.g., HTML 4.0 or an XML application).
An element is any identifiable object within a document, for example a character, word, image, paragraph or spreadsheet cell. In HTML and XML an element refers to a pair of tags and their content, or an "empty" tag - one which has no closing tag or content.
A property is a piece of information about an element, for example structural information (e.g., it is item number 7 in a list, or plain text) or presentation information (e.g., that it is marked as bold, its font size is 14). In XML and HTML properties of an element include the name of the element (e.g., IMG or DL), the values of its attributes, and information associated by means of a stylesheet. In a database, properties of a particular element may include values of the entry, and acceptable data types for that element.
in XML and HTML, an element may have any number of attributes. In the following example, the attributes of the beverage element are flavour, which has the value "lots", and colour, which has the value "red": <beverage flavour="lots" colour="red">my favorite</beverage> Some attributes are integral to document accessibility (e.g., the "alt", "title", and "longdesc" attributes in HTML
Rendered Content
The rendered content is that which an element actually causes to be rendered by the user agent. This may differ from the element's structural content. For example, some elements cause external data to be rendered (e.g., the IMG element in HTML), and in some cases, browsers may render the value of an attribute (e.g., "alt", "title") in place of the element's content.

Accessibility Terms

Accessible, Accessibility
Within these guidelines, Accessible and Accessibility are used in the sense of being accessible to people regardless of disability.
Accessibility Solution, Accessible Authoring Practice
These terms refer to Authoring practices which improve the accessibility of content generated by the tool..

Alternative Representation of Content

Alternative Textual Representations
Certain types of content may not be accessible to all users (e.g., images), so authoring tools must ensure that alternative textual representations ("Alt-text") of information is available to the user. Alternative text can come from element content (e.g., the OBJECT element) or attributes (e.g., "alt" or "title").
Description Link (D-link)
A description link, or D-Link, is an author-supplied link to additional information about a piece of content that might otherwise be difficult to access (image, applet, video, etc.).
A transcript is a line by line record of all dialog and action within a video or audio clip.
Video Captions
A video caption is a textual message that is stored in the text track of a video file. The video caption describes the action and dialog for the scene in which it is displayed.

Selection, Focus, and Events

An authoring tool may offer several views of the same document. For instance, one view may show raw markup, a second may show a structured tree view, a third may show markup with rendered objects while a final view shows an example of how the document may appear if it were to be rendered by a particular browser.
Editing view
What is displayed by the authoring tool to the author during the editing process.

4 Acknowledgments

Many thanks to the following people who have contributed through review and comment: Jim Allan, Denis Anson, Kynn Bartlett, Harvey Bingham, Judy Brewer, Carl Brown, Dick Brown, Kelly Ford, Wendy Chisholm, Rob Cumming, Daniel Dardailler, Mark Day, BK Delong, Jamie Fox, Sylvain Galineau, Al Gilman, Eric Hansen, Phill Jenkins, Len Kasday, Brian Kelly, William Loughborough, Karen McCall, Charles Oppermann, Dave Pawson, Dave Poehlman, Bruce Roberts, Chris Ridpath, Gregory Rosmaita, Jim Thatcher, Irène Vatton, Gregg Vanderheiden, Pawan Vora, Jason White, and Lauren Wood.

If you have contributed to the AU guidelines and your name does not appear please contact the editors to add your name to the list.

5 References

"CSS, level 1 Recommendation", B. Bos, H. Wium Lie, eds. The CSS1 Recommendation is available at:
"CSS, level 2 Recommendation", B. Bos, H. Wium Lie, C. Lilley, and I. Jacobs, eds. The CSS2 Recommendation is available at:
"HTML 4.0 Recommendation", D. Raggett, A. Le Hors, and I. Jacobs, eds. The HTML 4.0 Recommendation is available at:
"W3C Technical Reports and Publications" The latest versions of W3C Recomendations are available at:
"Authoring Tool Accessibility Techniques (Working Draft)", J. Treviranus, J. Richards, I. Jacobs, and C. McCathieNevile eds. The latest working draft of these techniques is available at:


"User Agent Accessibility Guidelines", J. Gunderson and I. Jacobs, eds. These guidelines for designing accessible user agents are available at:
"Web Content Accessibility Guidelines 1.0", W. Chisholm, G. Vanderheiden, and I. Jacobs, eds. These guidelines for designing accessible documents are available at:
"Techniques for Web Content Accessibility Guidelines", W. Chisholm, G. Vanderheiden, and I. Jacobs, eds. These techniques for designing accessible documents are available at:
Priorities defined by [WAI-WEBCONTENT].