comments on WD-WAI-AUTOOLS-TECHS-19991026

Here is a minor typo report for Techniques [1] "work in progress". Line
numbers refer to the HTML source.


Comments

alt appears as alt-text, alt text, "alt-text", alt, "alt", and "alt"-text
(and alternative text). I would try to settle on one representation and use
it throughout. Maybe "<code>alt</code>"-text

Mostly they are, but every instance of alt, BR, height, IMG, longdesc, P,
src, title, and width could be CODE (or TT or SAMP, but it looks like
you're settled on CODE). (See lines 519-521, 800, 846, 925-926, 934, 1248,
1372-1373, 1399, 2180, 2185-2187.)

The draft would read better if "etc." could be eliminated whenever it adds
no information.


Line Items

Starting here, line numbers are followed by a quote and an attempted
correction. Comments are in brackets [].

line 449
tracks.An
tracks. An

line 461
checking, readability level.
checking, and readability level.

line 477
reversible)
reversible.)

line 486
title</code>
title</code>.

line 491
formatting)
formatting).

line 506
or or
or

line 578
always), can keep
always), and can keep

lines 734-735
to the DTD (and to get back into HTML mode requires correcting the errors.
Refer
to the DTD (and to get back into HTML mode requires correcting the errors).
Refer

line 786
images, audio, video.
images, audio, and video.

line 856
markup.Word
markup. Word

lines 976-977
[The first time Alternative Information Management Mechanism is
mentioned it could be capitalized as it is on lines 1437-1438 (where
quotes might not be necessary -- would AIMM work there?).]

lines 1104-1105
help Refer
help. Refer

line 1208
(although editing may cause</li>
[line seems to be truncated]

line 1249
Word processor
word processor

line 1433-1440
"...For example, when requesting equivalent alternatives for an
    image with the HTML OBJECT element, offer an unchecked
    option for a null value (i.e., there is no content,
    implying the image has no real function) with the cursor
    positioned in the entry field for alternative text (and if
    available provide the appropriate value from the
    "Alternative Information Management Mechanism" Refer also
    to checkpoint 3.5., rather than offering the filename as a
    default suggestion, or selecting the null "alt" value as a
    default."
[Cut into two or more sentences. One proposed new version follows:]
"...For example, when requesting equivalent alternatives for an
    image with the HTML OBJECT element, and there is no content
    which implies the image has no real function, offer an
    unchecked option for a null value. Position the cursor in
    the entry field for alternative text, and, if available,
    provide the appropriate value from the Alternative
    Information Management Mechanism, rather than offering the
    filename as a default suggestion, or selecting the null
    "alt" value as a default. Refer also to checkpoint 3.5."

line 1484
[WAI-WEBCONTENT]
[could link to #ref-WAI-WEBCONTENT]

line 1499
Amaya, that
Amaya that

lines 1563-1573
"...Accessible authoring features are added to the
    documentation as they are incorporated into Amaya, as part
    of the normal documentation of the relevant feature."
[In the other checkpoints, the Amaya information is
third to last in the list. Here it is fifth to last,
and maybe could be moved down two slots.]

same on lines 1952-1954
"...Amaya allows each attribute to be edited through the menu
    or through the structure view. Element types can be
    assigned through the menu system."
[Amaya is eighth to last, and could be third to last.]

line 1800
Provide Keyboard access
Provide keyboard access

line 1806
["interface." is the only line in this list ending
with a period. I'd say make them all the same.]

line 1839
manner (labels
manner; (labels

line 1932
Operating System
operating system

lines 2162-2164
[Not sure.]
"...incorporates an "Alternative Information Management
    Mechanism" Refer also to checkpoint 3.5. to manage...."
"...incorporates an Alternative Information Management
    Mechanism (refer also to checkpoint 3.5) to manage...."

line 2180
etc)
etc.)

lines 2473-2475
"...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 description link, or D-Link, is an author-supplied link
    to additional information about a piece of content (image,
    applet, video, etc.) that might otherwise be difficult to
    access."

line 2490
User Interface
user interface

line 2914-2915
[To match the others, this could read as follows.]
The <a href="http://www.w3.org/TR/WAI-AUTOOLS">latest version</a> is
available at http://www.w3.org/TR/WAI-AUTOOLS.


Reference

[1] http://www.w3.org/TR/1999/WD-WAI-AUTOOLS-TECHS-19991026/

Best wishes, and good luck with your draft.

--
Susan Lesch
susan@textet.com
http://www.textet.com/

Received on Saturday, 27 November 1999 17:59:46 UTC