From owner-freebsd-doc@FreeBSD.ORG  Fri Jul  9 18:09:12 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 81F9B16A4CE; Fri,  9 Jul 2004 18:09:12 +0000 (GMT)
Received: from wonkity.com (wonkity.com [65.173.111.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 12E9D43D48; Fri,  9 Jul 2004 18:09:12 +0000 (GMT)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.12.11/8.12.11) with ESMTP id i69I9Buo056496;
	Fri, 9 Jul 2004 12:09:11 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i69I9Bmx056493;
	Fri, 9 Jul 2004 12:09:11 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Fri, 9 Jul 2004 12:09:11 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Bill Moran <wmoran@potentialtech.com>
In-Reply-To: <20040709125207.66591fc2.wmoran@potentialtech.com>
Message-ID: <20040709120642.J56489@wonkity.com>
References: <200407091038.52304.zettel@acm.org>
	<20040709160642.GB29928@submonkey.net>
	<20040709125207.66591fc2.wmoran@potentialtech.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3
	(wonkity.com [127.0.0.1]); Fri, 09 Jul 2004 12:09:11 -0600 (MDT)
cc: Ceri Davies <ceri@freebsd.org>
cc: freebsd-doc@freebsd.org
Subject: Re: Acronyms believed harmful
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 09 Jul 2004 18:09:12 -0000

On Fri, 9 Jul 2004, Bill Moran wrote:

> Before I start, I have a policy question:  If we look at tech terms
> that are NOT FreeBSD-specific (such as DTD) should the FreeBSD
> glossary contain a full definition, or possibly a link to another
> source?

Let me suggest both: a quick definition and then a link to another 
source for more information.

For example:

DTD: Document Type Definition.  See (link to xml.org or some place more 
generic).

-Warren Block * Rapid City, South Dakota USA