W3C home > Mailing lists > Public > w3c-wai-gl@w3.org > July to September 2005

Re: example format for Guide DOc (for 1.1 L1 SC1)

From: Christophe Strobbe <christophe.strobbe@esat.kuleuven.be>
Date: Thu, 15 Sep 2005 20:45:42 +0200
Message-Id: <>
To: <w3c-wai-gl@w3.org>

At 19:28 15/09/2005, Gregg Vanderheiden wrote:
   Here is an example implementation for discussion to day for the Guide 
Doc format.

The shorter links in the right hand navigation bar are an improvement.

The definition links in the  text of the guideline and success criterion 
(quoted at the top) point to the definitions in the Guidelines document, 
not to those in the Guide Doc.

The "options deemed sufficient by the working group" and the 
technology-independent techniques are merged into one section. In my own 
draft for the Guide Doc for 3.2 L3 SC2, the technology-specific techniques 
were essentially duplicates of the "options deemed sufficient...", so this 
change looks good. The emphasis in the new structure is also a better 
representation of the hierarchy: first look what your situation is (bold 
text), than find the options/techniques.

I wouldn't remove the word "Guideline" from the title (<h1>). The <title> 
element should also be more descriptive.

There is something wrong with the markup for the first example: list items 
b should really be a paragraph of list item a.
Minor comment: the type attribute on <ol>, <ul> and <li> is deprecated. We 
could replace <ol type="a"> with the CSS declaration "list-style-type: 

Content-wise: is "using a valid text alternative" now assumed to be 
implicit in the other techniques?

If I may put on my linguistics hat: when a list is a continuation of a 
sentence, punctuation and capitalisation should reflect this. For example 
in the previous version of the template:

Providing long descriptions by...
- using noembed with embed,
- using longdesc.

instead of

Providing long descriptions by...
- using noembed with embed
- using longdesc

In the new template, this would become:

Providing long descriptions in HTML
- Using noembed with embed,
- using longdesc.


Providing long descriptions in HTML
- Using noembed with embed.
- Using longdesc.


Christophe Strobbe


Christophe Strobbe
K.U.Leuven - Departement of Electrical Engineering - Research Group on 
Document Architectures
Kasteelpark Arenberg 10 - 3001 Leuven-Heverlee - BELGIUM
tel: +32 16 32 85 51

Disclaimer: http://www.kuleuven.be/cwis/email_disclaimer.htm
Received on Thursday, 15 September 2005 18:47:00 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 16 January 2018 15:33:56 UTC