[SpecGL] C1: Define your terms, GP 1

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 Monday, 26 July 2004 10:15:04 UTC