From owner-freebsd-doc@FreeBSD.ORG Sun Apr 4 06:44:17 2004 Return-Path: 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 EEF0016A4CE; Sun, 4 Apr 2004 06:44:17 -0700 (PDT) Received: from zaphod.nitro.dk (0x53584e1d.boanxx18.adsl-dhcp.tele.dk [83.88.78.29]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1E50243D5E; Sun, 4 Apr 2004 06:44:17 -0700 (PDT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 345A8114B2; Sun, 4 Apr 2004 15:44:14 +0200 (CEST) Date: Sun, 4 Apr 2004 15:44:14 +0200 From: "Simon L. Nielsen" To: Ceri Davies Message-ID: <20040404134413.GB2933@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ftEhullJWpWg/VHq" Content-Disposition: inline User-Agent: Mutt/1.5.6i cc: freebsd-doc@freebsd.org Subject: Re: Glossary [was: docs/64144: [patch] document procedure to add a new ports category to Committer's Guide] X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 04 Apr 2004 13:44:18 -0000 --ftEhullJWpWg/VHq Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [CC trimmed even more for new topic. Second try, which hopefully won't be caught by spam filters] On 2004.04.02 02:27:26 +0100, Ceri Davies wrote: > Regarding the glossary, how does everyone think that's working out? I > notice that it's been short of attention recently and wanted to check > that people still think it's a nice idea before I do some work on it. Even though it hasn't been getting much attention I still think it's a very good idea. > My current thinking at the moment is to do away with the > FreeBSD-specific aspect and make it more general, then fiddle the You mean make it both FreeBSD and general? That would probably be a good idea, and also give the glosserary a better reason for for existing if it has more actual content. > stylesheets to create links to the glossary term for firstterm and > acronym elements That sounds like a real neat idea. Acronyms can appear many times on one page, so perhaps only the first occurrence on a page should be marked up with a link. Eg. like only the first occurrence a trademark on a page gets the trademark symbol. > (once I've worked my way through Teach Yourself Scheme > in Fixnum Days [1]) and, perhaps, eventually one day it will be an error Uhh Scheme... Just make sure you have spare keyboard laying around when you parenthesis keys gets worn out ;-). > to add one of those elements without a matching glossary entry. Much as > I love it when a plan comes together, this will probably take a while, > and I want to check the water before I dive in. Sounds like a good plan to me. > [1] http://www.ccs.neu.edu/home/dorai/t-y-scheme/t-y-scheme.html for > those who may be interested. That was also one of the tutorials I used when I made the trademark stylesheet stuff. Others I used was http://www.netfolder.com/DSSSL/index.html and http://coli.lili.uni-bielefeld.de/Texttechnologie/dsssl_ma/dsssl/index.html= . --=20 Simon L. Nielsen FreeBSD Documentation Team --ftEhullJWpWg/VHq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFAcBEth9pcDSc1mlERAloYAJ4lumQqfizbihp8EfuyoXfdJwXhvQCfQlM1 nFCimXjl81lZDjuOeRBM0n0= =F3Rr -----END PGP SIGNATURE----- --ftEhullJWpWg/VHq--