- From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
- Date: Tue, 27 Jul 2004 19:08:42 -0400
- To: Dominique Hazaël-Massieux <dom@w3.org>, www-qa-wg@w3.org
Nice Dom. Looks good as is. No comments. --Lynne At 04:14 PM 7/26/2004 +0200, Dominique Hazaël-Massieux wrote: >1st GP for section C1; it would come after the principles > >---------------- >Good Practice: define the terms in-line, and consolidate the definitions >in a glossary section > >What does this mean? >Put the definition of any new term along with its first occurrence in >the text, but make sure that all the definitions are also available from >a central glossary section. > >Why care? >Having the definition in-line makes it easier to read the whole >specification from top to bottom, while having a centralized section of >defined terms makes it handy to look up a term when looking at a >specific section, or for others to re-use your definitions. > >Technique: >- if you use XMLspec to edit the specification, using <termdef> and ><term> to markup the in-line definitions makes it possible to get >automatically a glossary with <glist> >- if you use XHTML, extracting the glossary from the in-line definitions >can be done with XSLT (see e.g. >http://www.w3.org/2004/07/def-to-glossary.xsl ) > >-- >Dominique Hazaël-Massieux - http://www.w3.org/People/Dom/ >W3C/ERCIM >mailto:dom@w3.org >
Received on Tuesday, 27 July 2004 19:09:20 UTC