[WCAG Overview & Navigating pages] revisions completed and question

EOWG:

I implemented the changes from the EOWG list and teleconference to:
- WCAG Overview: www.w3.org/WAI/EO/Drafts/sketchpad/wcag-intro.html
- Navigating WCAG 1.0 Guidelines and Techniques Documents (previously
WCAG 1.0 Document Link Example):
www.w3.org/WAI/EO/Drafts/sketchpad/wcag-flow
	
COMMENTS
If you have additional comments or issues on the content, please send
them to the EOWG list for discussion.
- Requirements for Overview Pages [formerly referred to as Intro pages]
for WAI Site is at:
	http://www.w3.org/WAI/EO/Drafts/UCD/intro-pages.html
- Before sending comments, please see "SENDING ISSUES" in:
http://lists.w3.org/Archives/Public/w3c-wai-eo/2004JulSep/0039.html
- Feel free to send typos and other edits that do not need discussion to
wai-eo-editors@w3.org so as not to clutter up the EOWG issues
discussion.
- Reminder that we are focusing on content only for now - not layout and
design, which will be determined with site redesign.

SPECIFIC QUESTION

I debated about what details to put in the Overview ("What is in WCAG"
section) versus in the Navigation doc:

details info such as:
-  ... guidelines that are general principles of accessible design. Each
guideline has one or more checkpoints that explain how the guideline
applies in a specific area. The How the Guidelines are Organized section
of WCAG 1.0 lists the format of guidelines and checkpoints.
-  ... specific techniques documents provide implementation guidance,
including explanations, strategies, and detailed markup examples.

1. The versions above duplicate much of the information in both places:
	- www.w3.org/WAI/EO/Drafts/sketchpad/wcag-intro.html#whatis
and	- www.w3.org/WAI/EO/Drafts/sketchpad/wcag-flow
* pro: if you only read the Overview, you get the info
* pro: from Navigating, you don't have to go back to Overview to get
info
* con: repetitive if you read both documents in the same sitting
* con: makes both pages longer and more complex

2. Here is an alternative version of WCAG Overview that has less in that
section:
	www.w3.org/WAI/EO/Drafts/sketchpad/wcag-intro-inflow.html#whatis
* pro: makes this page much shorter
* pro: avoids duplication between the two documents
* con, weak: someone who might want the information might not get it if
they only read the Overview

3. Here is an alternative version of Navigating that has less:
	www.w3.org/WAI/EO/Drafts/sketchpad/wcag-flow-nav
* pro: makes this page simpler
* pro: avoids duplication between the two documents
* con, STRONG: people might need to go back and forth between the two
documents to get all the information they need

Please send your thoughts to the EOWG list. Thanks!

Best,

~ Shawn

Received on Saturday, 31 July 2004 17:36:49 UTC