W3C home > Mailing lists > Public > www-qa-wg@w3.org > July 2004

[SpecGL] C1: define your terms, GP 2

From: Dominique HazaŽl-Massieux <dom@w3.org>
Date: Mon, 26 Jul 2004 16:24:16 +0200
To: www-qa-wg@w3.org
Message-Id: <1090851855.29618.174.camel@stratustier>
2nd (and last) GP for section C1.

--------------------------
Good practice: re-use existing terms, and don't redefine them

What does this mean?
When a definition for a term already exists (e.g. in a different
specification) and matches your needs, re-use the term and its
definitions without changing them, and with a reference to the source.

Why care?
Re-using existing terms reduce the cost of crafting new definitions, and
makes it easier for readers already familiar with other specifications
to get into a new one. Also, conflicting definitions of the same term
leads to a reduced interoperability.

Technique:
- use the W3C Glossary system to check if there are existing definitions
of the term you want to re-use
- when quoting a definition from another specification, put a link back
to the specification 
-- 
Dominique HazaŽl-Massieux - http://www.w3.org/People/Dom/
W3C/ERCIM
mailto:dom@w3.org


Received on Monday, 26 July 2004 10:24:49 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:14:33 UTC