RE: W3C Technologies - draft intro - update#2

Thanks for the comments Shawn - see update attached.

All addressed apart from #3 which I will do later - requires a bit more 
thought than I have time for this afternoon.

Andrew








"Shawn Lawton Henry" <shawn@w3.org>
14/07/2004 01:53 PM

 
        To:     <Andrew.Arch@visionaustralia.org.au>, <public-wai-eo-site@w3.org>
        cc: 
        Subject:        RE: W3C Technologies - draft intro - update


Thanks, Andrew, for sending this out. Very helpful to have something to
look at!

Here are some suggestions for your consideration:

1. fix the <title> (still says uaag :)

AA: DONE

2. consider taking out "Audience" as I think it doesn't really provide
pertinent information for this page ?

AA: agreed - DONE

3. what do you think about using a general format for each section of:
    1. a short paragraph explaining what [CSS, SMIL, SVG, HTML] is
    2. a short paragraph (or bullet points?) summarizing or highlighting
the content of the document

AA: was trying to keep it short - maybe too short - will give it a go with 
this style (later)

the current version already has much of this information - just
wondering if it would be helpful to separate it out more clearly and
consistently?

4. consider changing "About W3C Technologies" to "Accessibility of W3C
Technologies"

AA: sure - DONE

5. hide "skip links, jump to content" and "navigation path: W3C Home >
WAI Home > About WAI > @@@@?" (so as to avoid reviewers being distracted
by those elements)

AA: ok - DONE

6. to be consistent with the others [1] - IF you think it is helpful,
consider adding at the end something like:
"Note format
The Notes in this document follow the W3C format for Notes. W3C Notes
include at the beginning: version links, editors, copyright, abstract,
status, and table of contents."
"Who develops these Notes
WAI Notes are developed by _working groups_ in the World Wide Web
Consortium (W3C) Web Accessibility Initiative (WAI). The W3C Note
development process includes formal periods for public review.
Opportunities for review of WAI documents are announced on the WAI home
page and WAI Interest Group mailing list. Other opportunities for
contributing are listed in Participating in WAI.
"
[1] see "Format for Intro pages" in
http://www.w3.org/WAI/EO/Drafts/UCD/intro-pages and
http://www.w3.org/WAI/EO/Drafts/UCD/intro-pages -- which are updated
from the WSTF teleconference

AA: DONE

7. "Related Documents Do we need to bring in some cross referencing to
the Guidelines and Techniques documents? Maybe this material could go in
a side bar."

I hope with the site-wide navigation that will be unnecessary. What do
you think about:
- removing this section
- adding near the top something like: "WAI developed a series of
accessibility guidelines, which are listed in _Guidelines and
Techniques_ page. _Components of Web Accessibility_ explains the
relationship between the different guidelines."
- adding under the CSS section a link to CSS Techniques for WCAG 1.0 and
under the HTML section a link to HTML Techniques

AA: Good idea - DONE

8. "References [1] W3C in Seven Points"

I'm pretty sure we can use wording from other documents without
referencing them - so it might be simpler to remove this?

AA: DONE - makes it simpler too.

9. "Editor: WSTF. Last updated $Date: 2004/07/14 $ by $Author: andrewa
$"

Editor is you! last updated date & name are automatically generated by
the system when the page is uploaded or changed online

AA: OK

===

Go ahead and send it to the EOWG list as soon as you are ready - with a
reference to: 
http://lists.w3.org/Archives/Public/w3c-wai-eo/2004JulSep/0043.html
 
THANKS!

~ Shawn