Copy edit comments on XHTML Vocabulary Namespace doc

Hello,
*

Sections 2-3.1:* Would be nice if all entries were stated consistently. For
sections 2-3.1, either capitalizing the term in the description ("Help
refers to a") or cutting the term (Refers to a resource").

*Section 3.1*

*Bookmark*: "bookmark - a link" should be "bookmark—a link". A dash with no
spaces. Not a hyphen.

*Chapter:* Typo. "collection" is mispelled as "collction".

*Help:* "Help refers to a resource that offers instructional assistance"? I
hate to see a term define the same term.

*Up: *Change to "Up refers to a preceding resource in a hierarchically
structured set." From the MS Manual of Style for Technical Publications: "*Do
not use (above) to mean earlier. Use previous, preceding, or **earlier
instead***."

*Main: *"Main indicates the main content"???

*Note: *"Note indicates that the content".
*
Section 3.2

Checkbox: *"A control that has three possible values: true, false, or mixed
(tri-state)."

*Combobox:* "a presentation of a select" seems a bit awkward to read. "A UI
element where users can select an option from a list or type their selection
into a field"?

*Description:* Would suggest "references this element by using describedby"
"via" usually means something physically passing through something else.

*Grid:* "columns (for example, a table)."

*Group: *"A group is a selection of user interface objects that would not".*

Link:* "and thus be a link)*.*" Add period to end.

*Log:* "game log, or an error log." Add comma.

*Menubar:* 'A menu bar is a container".
*
Menuitem:* "One choice in a menu. (note, that in XHTML 2.0 any element can
have an href attribute and thus be a link)."
*
Radio:* "Only one radio control in a radiogroup can be selected at any given
time."

*Region:* "A region is a large, preceivable section".

Slider: A user input where the user selects an input within a given range.

Received on Monday, 29 September 2008 16:15:08 UTC