Re: TCDL usage document: what is its purpose?

Hi Shane, All,

Quoting Shane Anderson <shane@cpd2.usu.edu>:
> (...)
> So far the usage document is not too helpful. What exactly is 
> the main goal of the usage document? 
> Is it a reference for TCDL language or a "how to"
> document?

The usage document is meant to be a short description of how the task 
force uses TCDL. The reference for the TCDL language itself is 
http://bentoweb.org/refs/TCDL2.0.html and it seems preferable not to 
duplicate most of that information.
The usage document still needs some work to make it more useful and 
more inviting for outsiders and newcomers, and I will continue working 
on it next week.

One of the things we can do is to add a list or table similar to the 
one in Appendix B of EARL (http://www.w3.org/TR/2006/WD-EARL10-Schema-
20060927/#terms-list).
Any other ideas on how to make the document more useful would be 
welcome. I have attached a slightly updated version to this mail.


> Under section "Terms and Definitions" the links to WCAG 2 and 
> W3C QA Voc. do not work.

Ah, yes, the "References" section is empty.


> I assume some of the more obvious errors are known (e.g.
> level "1" on every section).

The comment in parentheses is not clear. Are you referring to the fact 
that Firefox numbers each section as "1"? I intend to replace the CSS-
generated numbers by manual numbering, but was waiting to do this until 
the document was stable.


Best regards,

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
http://www.docarch.be/ 


Disclaimer: http://www.kuleuven.be/cwis/email_disclaimer.htm