From owner-freebsd-doc Wed May 26 12: 1:41 1999 Delivered-To: freebsd-doc@freebsd.org Received: from alice.gba.oz.au (gba-254.tmx.com.au [203.9.155.254]) by hub.freebsd.org (Postfix) with SMTP id 91C5515521 for ; Wed, 26 May 1999 12:01:33 -0700 (PDT) (envelope-from gjb@acm.org) Received: (qmail 12842 invoked by uid 1001); 26 May 1999 01:34:16 -0000 Message-ID: <19990526013416.12841.qmail@alice.gba.oz.au> X-Posted-By: GBA-Post 1.03 20-Sep-1998 X-PGP-Fingerprint: 5A91 6942 8CEA 9DAB B95B C249 1CE1 493B 2B5A CE30 Date: Wed, 26 May 1999 11:34:15 +1000 From: Greg Black To: Nik Clayton Cc: doc@FreeBSD.ORG, freebsd-translate@ngo.org.uk Subject: Re: FDP Directory Reorganisation References: <19990513211458.B70767@catkin.nothing-going-on.org> <19990519214022.D60921@catkin.nothing-going-on.org> <19990520095342.18541.qmail@alice.gba.oz.au> <19990520232510.A54603@catkin.nothing-going-on.org> <19990523023158.105.qmail@alice.gba.oz.au> <19990524100236.V12185@lehman.com> In-reply-to: <19990524100236.V12185@lehman.com> of Mon, 24 May 1999 10:02:36 +0100 Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > > [Re "articles" and "books":] > > If the > > object of the documentation is to provide help to the users of > > the documentation, then the organisation needs to based on > > distinctions that make sense to those users. > > Disagree. Here's why. > > The organisation *within the repository* is (or should be) of zero > interest to the end user of the documentation. There's no reason why the > directory hierarchy within the repository, and the directory hierarchy of > the installed documentation should map to each other one to one. > > [...] > > For example, something that lives in the books/printing directory might > have > > CATEGORIES= books sysadmin printing mswindows > > in the Makefile, indicating that the formatted documentation should be > installed in to /usr/local/share/doc/FDP/{books,sysadmin,printing,mswindows} > directories because > > 1. It's a "book" > 2. Printing is a "Sys Admin" topic. > 3. Printing is deemed to be important enough to have it's own top level > category as well. > 4. It explains how Windows hosts can print to printers attached to > FreeBSD boxes. > > This gives the end-user much more freedom when it comes to finding the > documentation they need. I have no problem with this -- but it was not spelled out in the proposal that I was commenting on, hence my repeated attempts to have the problem that I saw addressed. I am quite happy to see semantic distinctions internal to the documents determining their location in the source (where they are accessed by the documentation maintainers), so long as the organisation that is visible to users allows them to find things by criteria that make sense to those users. Your latest answer indicates that this will be done. Thanks. -- Greg Black -- or To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message