From owner-freebsd-doc Fri May 14 23:13:43 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 3EA7B14D27 for ; Fri, 14 May 1999 23:13:27 -0700 (PDT) (envelope-from gjb-freebsd@gba.oz.au) Received: (qmail 27874 invoked by uid 1001); 15 May 1999 05:31:46 -0000 Message-ID: <19990515053146.27873.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: Sat, 15 May 1999 15:31:46 +1000 From: Greg Black To: Nik Clayton Cc: freebsd-doc@FreeBSD.ORG Subject: Re: FDP Directory Reorganisation References: <19990513211458.B70767@catkin.nothing-going-on.org> In-reply-to: <19990513211458.B70767@catkin.nothing-going-on.org> of Thu, 13 May 1999 21:14:58 +0100 Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > Migrate to a new directory structure that follows this layout; > doc/ > / > / > articles/ > fonts/ > ... > books/ > FAQ/ > FDP-primer/ > printing/ > ... > man/ > ... > share/ > sgml/ > share/ > ... > share/ > sgml/ > ... > mk/ > ... Speaking from the perspective of somebody who is new to FreeBSD (but who expects to be here for the long haul), I find a problem with the distinction between "articles" and "books" -- as I read the proposal, the only distinction between these directories is that "books" are longer. To me, this is an artificial distinction. If all the "books" and "articles" are a similar set of documents -- some longer and some shorter, some more tutorial and some less so -- then surely they could all live in one directory as this would make the task of finding the document that you wanted much simpler. I quite understand the intention behind this reorganisation, but I fear that it may go too far in complexity if the "articles" and "books" distinction is retained. Of course, the underlying issue may be that there are too many entries to work well in a single directory. If that is the case, then surely it would be better to divide it up by some kind of topic-based plan. -- Greg Black To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message