ATAG20 glossary evaluation
ATAG 2.0 Terms and Definitions |
WAI Glossary Comparison |
JR's Comments |
- Accessibility (Also: Accessible)
- Within these guidelines,"accessible Web content" and "accessible authoring
tool" mean that the content and tool can be used by people regardless
of disability. To understand the accessibility issues relevant to authoring
tool design, consider that many authors may be creating content in contexts
very different from your own:
- They may not be able to see, hear, move, or may not be able to
process some types of information easily or at all;
- They may have difficulty reading or comprehending text;
- They may not have or be able to use a keyboard or mouse;
- They may have a text-only display, or a small screen.
Accessible design will benefit people in these different authoring scenarios
and also many people who do not have a physical disability but who have
similar needs. For example, someone may be working in a noisy environment
and thus require an alternative representation of audio information.
Similarly, someone may be working in an eyes-busy environment and thus
require an audio equivalent to information they cannot view. Users of
small mobile devices (with small screens, no keyboard, and no mouse)
have similar functional needs as some users with disabilities.
|
1 def'n
(atag-match)
|
In our def'n, we mix up the two senses (tool vs. produced
content). I suggest we keep them separate:
- Accessible Application:
- Application that has an increased likelihood of being easier to use
by people with disabilities or people who are using the application
under circumstances that impair their sensory or motor performance.
For more information, see checkpoints 1.1 to 1.6.
This entails some changes:
- Guideline 1: Ensure that the tool is an *accessible
application*
- Checkpoint 1.1: Ensure that the authoring interface
follows all operating environment conventions for an *accessible application*
- Checkpoint 1.2: Ensure that the authoring interface
enables editing of all element and object properties as required for
an *accessible application*.
- Checkpoint 1.5: Ensure that the authoring interface
enables keyboard navigation of editing views via the document
structure.
- Accessible Web Content:
- Web content that conforms with *WCAG*. This Web content has an increased
likelihood of being easier to use by people with disabilities or people
who are using the application under circumstances that impair their
sensory or motor performance. For more information, see *WCAG*.
This entails some changes:
- Guideline 2: Ensure that the tool is designed to
produce *accessible Web content*
- Checkpoint: 2.3: Ensure that the author can produce
*accessible Web content* in the markup language(s) supported by the
tool.
- Checkpoint: 2.4: Ensure that the tool preserves *accessible
Web content* during transformations and conversions.
- Checkpoint: 2.5: Ensure that any Web content automatically
generates by the tool is *accessible Web content*
- Checkpoint: 2.6: Ensure that all pre-authored Web
content for the tool is *accessible Web content*.
- Guideline 3: Support the author in the production
of *accessible Web content*
- Checkpoint 3.7: Document all features of the tool
that promote the production of *accessible Web content*.
- Checkpoint 3.8: Document the process of using the
tool to produce *accessible Web content*.
- Checkpoint 4.4: Ensure that creating *accessible
Web content* is a naturally integrated part of the documentation, including
examples.
|
Accessibility Information
"Accessibility information" is content, including information and
markup, that is used to improve the accessibility of a document. Accessibility
information includes, but is not limited to, equivalent alternative information.
|
1 def'n
(atag-match) |
I suggest this is no longer needed if Checkpoint 2.4 is changed
as shown above. |
- Accessibility Problem (Also: Inaccessible Markup)
- Inaccessible Web content or authoring tools cannot be used by some
people with disabilities. The Web Content Accessibility Guidelines 2.0
[WCAG20] describes how to create
accessible Web content.
|
1 def'n
(atag-match) |
Outdated - I suggest:
- Accessibility Problem
- Instance of Web content that is not *accessible Web content*.
This entails a change:
- Checkpoint 3.6: Provide the author with a summary
of the degree to which *accessibility problems* are present.
|
- Accessible Authoring Practice
- "Accessible authoring practices" improve the accessibility of Web
content. Both authors and tools engage in accessible authoring practices.
For example, authors write clearly, structure their content, and provide
navigation aids. Tools automatically generate valid markup and assist
authors in providing and managing appropriate equivalent alternatives.
|
1 def'n
(atag-match) |
Outdated - I suggest:
- Accessible Authoring Practice
- An authoring practice (e.g. creating a stylesheet, creating a document
structure, writing clearly, etc.) that contributes to the production
*accessible Web content*.
This entails a change:
- Guideline 4: Integrate *accessible authoring practices*
into the overall "look and feel"
|
Alert
An "alert" draws the author's attention to an event or situation.
It may require a response from the author.
|
1 def'n
(atag-no match) |
Not used in ATAG2.0. |
- Alternative Information
(Also: Equivalent Alternative)
- Content is "equivalent" to other content when both fulfill essentially
the same function or purpose upon presentation to the user. Equivalent
alternatives play an important role in accessible authoring practices
since certain types of content may not be accessible to all users (e.g.,
video, images, audio, etc.). Authors are encouraged to provide text
equivalents for non-text content since text may be rendered as synthesized
speech for individuals who have visual or learning disabilities, as
Braille for individuals who are blind, or as graphical text for individuals
who are deaf or do not have a disability. For more information about
equivalent alternatives, please refer to the Web Content Accessibility
Guidelines WCAG 2.0 [WCAG20].
|
1 def'n
(atag/wcag-match except ref to wcag version) |
I suggest we use the edited first part of the WCAG def'n
instead:
- Equivalent
- Content is "equivalent" to other content when both fulfill
essentially the same function or purpose upon to the user. In the context
of this WC document, the equivalent must fulfill essentially the same
function for the person with a disability (at least insofar as is feasible,
given the nature of the disability and the state of technology), as
the primary content does for the person without any disability (e.g.
the text "The Full Moon" might convey the same information
as an image of a full moon when presented to users.).Note: that
equivalent information focuses on fulfilling the same function. If the
image is part of a link and understanding the image is crucial to guessing
the link target, an equivalent must also give users an idea of the link
target. Providing equivalent information for inaccessible content is
one of the primary ways authors can make their documents accessible
to people with disabilities.
This entails some changes:
- Checkpoint 3.4: Do not automatically generate *equivalents*
or reuse previously authored *equivalents* without author confirmation,
except when the context in which the original object is being used is
known with certainty.
- Checkpoint 3.5: Provide functionality for managing,
editing, and reusing *equivalents* for multimedia objects.
|
- Attribute
- This document uses the term "attribute" as used in SGML and XML [XML]: Element types may be defined as
having any number of attributes. Some attributes are integral to the
accessibility of content (e.g., the
"alt" , "title" ,
and "longdesc" attributes in HTML).
|
2 def'ns
(atag-no match)
(uaag-closer match)
|
Recommend we follow UAAG def'n:
- Attribute
- This document uses the term "attribute" in the XML sense:
an element may have a set of attribute specifications (refer to the
XML 1.0 specification [XML] section 3).
|
- Auditory Description
- An "auditory description" provides information about actions, body
language, graphics, and scene changes in a video. Auditory descriptions
are commonly used by people who are blind or have low vision, although
they may also be used as a low-bandwidth equivalent on the Web. An auditory
description is either a pre-recorded human voice or a synthesized voice
(recorded or automatically generated in real time). The auditory description
must be synchronized with the auditory track of a video presentation,
usually during natural pauses in the auditory track.
|
1 def'n (uaag-similar) |
Recommend we follow UAAG def'n:
- Auditory Description
- An auditory description is either a prerecorded human voice or a
synthesized voice (recorded or generated dynamically) describing the
key visual elements of a movie or other animation. The audio description
is synchronized with (and possibly included as part of) the audio track
of the presentation, usually during natural pauses in the audio track.
Audio descriptions include information about actions, body language,
graphics, and scene changes.
|
- Authored "by hand"
- When the author specifies the precise text string, as by typing into
a text editor.
|
NO def'n |
OK |
- Authoring Tool
- An "authoring tool" is any software that is used to produce content
for publishing on the Web. Authoring tools include:
- Editing tools specifically designed to produce Web content (e.g.,
WYSIWYG HTML and XML editors);
- Tools that offer the option of saving material in a Web format
(e.g., word processors or desktop publishing packages);
- Tools that transform documents into Web formats (e.g., filters
to transform desktop publishing formats to HTML);
- Tools that produce multimedia, especially where it is intended
for use on the Web (e.g., video production and editing suites, SMIL
authoring packages);
- Tools for site management or site publication, including tools
that automatically generate Web sites dynamically from a database,
on-the-fly conversion and Web site publishing tools;
- Tools for management of layout (e.g., CSS formatting tools).
|
1 def'n
(atag-no match) |
This will be defined at the top of the document. @@JR Action
Item@@ |
- Captions
- "Captions" are essential text equivalents for movie audio. Captions consist
of a text transcript
of the auditory track of the movie (or other video presentation) that
is synchronized with the video and auditory tracks. Captions are generally
rendered graphically and benefit people who can see but are deaf, hard-of-hearing,
or cannot hear the audio.
|
2 def'ns
(atag-no match)
(uaag-closer match) |
OK |
Check for
As used in checkpoint 4.1,"check for" can refer to three types of checking:
In some instances, an authoring tool will be able to check
for accessibility problems automatically. For example, checking
for validity (checkpoint 2.2) or testing whether an image is the only content
of a link.
In some cases, the tool will be able to "suspect" or "guess"
that there is a problem, but will need confirmation from the author.
For example, in making sure that a sensible reading order is preserved
a tool can present a linearized version of a page to the author.
In some cases, a tool must rely mostly on the author, and can
only ask the author to check. For example, the tool may prompt the
author to verify that equivalent alternatives for multimedia are
appropriate. This is the minimal standard to be satisfied. Subtle,
rather than extensive, prompting is more likely to be effective
in encouraging the author to verify accessibility where it cannot
be done automatically.
|
1 def'n
(atag-match) |
May not be required now that we have better techniques for
checking checkpoint. |
Conversion Tool
A "conversion tool" is any application or application feature (e.g.,"Save
as HTML") that transforms convert in one format to another format (such
as a markup language).
|
1 def'n
(atag-match) |
Not used in ATAG2.0. |
Document
A "document" is a series of elements that are defined by a markup language (e.g., HTML 4 or an XML application).
|
1 def'n
(atag-match) |
Does this really need a definition? None of the other specs
define it. |
- Editing View
- An "editing view" is a view provided by the authoring tool that allows
editing.
|
1 def'n
(atag-match) |
OK |
- Element
- An "element" is any identifiable object within a document, for example,
a character, word, image, paragraph or spreadsheet cell. In [HTML4] and [ XML], an element refers
to a pair of tags and their content, or an "empty" tag - one that requires
no closing tag or content.
|
5 def'ns
(atag-match)
(uaag)
(wcag)
(css)
(xml)
|
Perhaps we can use the XML def'n:
- Element
- An element is a document structuring unit declared in the DTD. The
element's content model is defined in the DTD, and additional semantics
may be defined in the prose description of the element. The proper name
for XML tags and the content they contain.
Example: <tag>content</tag>
|
- Inform
- To "inform" is to make the author aware of an event or situation through
alert, prompt, sound, flash, or other means.
|
1 def'n
(atag-match) |
I suggest:
- Inform
- To make the author aware of an event or state. The tool may inform
the author immediately or following an appropriate delay.
|
- Markup Language
- Authors encode information using a "markup language" such as HTML
[HTML4], SVG [ SVG], or MathML [MATHML].
|
1 def'n
(atag-match) |
WCAG looking for a def'n of "markup"- according to Glossary
"markup format"? |
Presentation Markup
"Presentation markup" is markup language that encodes information about
the desired presentation or layout of the content. For example, Cascading
Style Sheets [CSS1], [CSS2] can be used to control fonts,
colors, aural rendering, and graphical positioning. Presentation markup
should not be used in place of structural markup to convey structure. For example,
authors should mark up lists in HTML with proper list markup and style
them with CSS (e.g., to control spacing, bullets, numbering, etc.).
Authors should not use other CSS or HTML incorrectly to lay out content
graphically so that it resembles a list.
|
2 def'ns
(atag-match)
(wcag) |
Not used in ATAG2.0.. Also - we are too pushy in this def'n
- perhaps we can edit WCAG's def'n:
- Presentation markup
- Markup that achieves a stylistic (rather than structuring) effect.
For example, the B, I or FONT elements in HTML.
|
- Prompt
- In this document prompt does not refer to the narrow software sense
of a "prompt," rather it is used as a verb meaning to urge, suggest
and encourage. The form and timing that this prompting takes can be
user configurable. "Prompting" does not depend upon the author to seek
out the support but is initiated by the tool. "Prompting" is more than
checking, correcting, and providing help and documentation as encompassed
in guidelines 4, 5, 6. The goal of prompting the author is to encourage,
urge and support the author in creating meaningful equivalent text without
causing frustration that may cause the author to avoid access options.
Prompting should be implemented in such a way that it causes a positive
disposition and awareness on the part of the author toward accessible
authoring practices.
|
2 def'ns
(atag-no match)
(uaag) |
Outdated - I suggest the following from my proposal for
techniques for checkpoint 3.1:
- Prompt
- "Prompt" should not be confused with the narrow
software sense of the term. Instead, ATAG 2.0 uses "prompt"
in a wider sense, to mean the process of eliciting author input. This
process should be:
(1) initiated by the tool rather than the user.
(2) user configurable in form and timing.
(3) implemented in a way that invites authors to develop a positive
disposition and awareness towards accessible authoring practices
|
- Property
- 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 type of the element (e.g.,
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.
|
3 def'ns
(atag-match)
(uaag)
(svg) |
I suggest an update:
- Property
- A "property" is a piece of information about an element. This might
be the the element type or the value of one of its attributes or some styling information. In a database,
properties of a particular element may include values of the entry,
and acceptable data types for that entry.
|
Structural Markup
"Structural markup" is markup language that encodes information about
the structural role of elements of the content. For example, headings,
sections, members of a list, and components of a complex diagram can
be identified using structural markup. Structural markup should not
be used incorrectly to control presentation or layout. For example,
authors should not use the 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.
|
NO def'n |
Not used in ATAG2.0. WCAG has "Document Structure" |
- Transcript
- A "transcript" is a text representation of sounds in an audio clip
or an auditory track of a multimedia presentation. A "collated text
transcript" for a video combines (collates) caption text with text descriptions
of video information (descriptions of the actions, body language, graphics,
and scene changes of the visual track). Collated text transcripts are
essential for individuals who are deaf-blind and rely on Braille for
access to movies and other content.
|
1 def'n
(atag-match) |
OK |
- Transformation
- A "transformation" is a process that changes a document or object
into another, equivalent, object according to a discrete set of rules.
This includes conversion tools, software that allows the author
to change the DTD defined for the original document
to another DTD, and the ability to change the markup
of lists and convert them into tables.
|
1 def'n
(atag-match) |
Unclear how this differentiates from conversion - suggest
placeholder.
|
- User Agent
- A "user agent" is software that retrieves and renders Web content.
User agents include browsers, plug-ins for a particular media type,
and some assistive technologies.
|
4 def'ns
(atag-match)
(wcag) (uaag)
(P3P10) |
Suggest we expand our def'n to an edited version of UAAG's def'n:
"A user agent is software that retrieves and renders Web content,
including text, graphics, sounds, video, images, and other content
types. A user agent may require additional user agents that handle some
types of content. For instance, a browser may run a separate program or
plug-in to render sound or video. User agents include graphical desktop
browsers, multimedia players, text browsers, voice browsers, and assistive
technologies such as screen readers, screen magnifiers, speech synthesizers,
onscreen keyboards, and voice input software." |
- View
- Authoring tools may render the same content in a variety of ways;
each rendering is called a "view". Some authoring tools will have several
different types of view, and some allow views of several documents at
once. For instance, one view may show raw markup, a second may show
a structured tree, 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. A typical way to distinguish
views in a graphic environment is to place each in a separate window.
|
2 def'ns
(atag-match) (uaag) |
OK |
Orphaned ATAG terms in WAI Glossary:
- Accessibility Awareness
- Accessible
- Appropriate
- Automated markup insertion function
- Available
- Content
- Current user selection
- Description link
- Documentation
- Equivalent Alternative
- Focus
- Generation Tool
- Haptic
- Inaccessible markup
- Publishing Tool
- Rendered Content
- Rendered View
- Selection
- Site Management Tool
- User-Configurable Schedule
- Whiteboard
- Wizard
|