From owner-freebsd-doc Thu May 20 3:14:56 1999 Delivered-To: freebsd-doc@freebsd.org Received: from eagle.phc.igs.net (eagle.phc.igs.net [207.210.17.201]) by hub.freebsd.org (Postfix) with ESMTP id 5A141150D8 for ; Thu, 20 May 1999 03:14:52 -0700 (PDT) (envelope-from eagle@phc.igs.net) Received: from localhost (eagle@localhost) by eagle.phc.igs.net (8.9.3/8.9.3) with ESMTP id GAA90913; Thu, 20 May 1999 06:12:16 -0400 (EDT) (envelope-from eagle@phc.igs.net) X-Authentication-Warning: eagle.phc.igs.net: eagle owned process doing -bs Date: Thu, 20 May 1999 06:12:16 -0400 (EDT) From: Rob Garrett To: Greg Black Cc: Nik Clayton , doc@FreeBSD.ORG, freebsd-translate@ngo.org.uk Subject: Re: FDP Directory Reorganisation In-Reply-To: <19990520095342.18541.qmail@alice.gba.oz.au> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org hmm, other On Thu, 20 May 1999, Greg Black wrote: > > The main change is replacing lang/encoding with lang.encoding, based on > > the contents of /usr/share/locale. The articles/books/man split is > > still there, and will remain unless someone can come up with something > > better. > > I'm really disappointed to see books and articles still there, > especially since all the feedback that I saw was in favour of > eliminating the arbitrary distinction. > > > Why bother with the distinction between books and articles? > > > > We need something to distinguish between manual pages and everything > > else. Otherwise we would have this directory filled with one directory > > for piece of documentation, and then one more directory which would > > contain all the manual pages. This is not an appealing idea. > > > > So we need at least one directory to lump all the non-manual pages in > > to. Finding a useful name for this one directory is hard. tutorials is > > wrong, as many of them are not tutorials. docs is too non-specific > > (after all, the manual pages are ``docs'' as well). > [...] > > I am prepared to replace this with just one directory if someone can > > come up with a good name for it. > > Just because it's a bit difficult to dream up the best name for > this directory is a poor reason to impose an arbitrary division > of similar documents based purely in their length. > > If nothing better is proposed, just call it "doc". It's not > hard to figure out that "doc" means everything except the man > pages (and it's not hard to say that somewhere). Of course, if > somebody comes up with a better name than doc, then I'm all for > it. But I am convinced that splitting this stuff into "books" > and "articles" is a mistake -- and exactly the kind of mistake > that should be strenuously avoided at a time like this when the > whole structure is being revamped anyway. > > The other comment I'd make is that it's time to stop using names > with upper case in them. If there is a strong historical reason > why lots of people will be seriously inconvenienced if names > like "FDP-primer" and "FAQ" are replaced by "fdp-primer" and > "faq", then this can be solved for the time being with symlinks > and a note that the symlinks are going to disappear when 4.x > comes out. > > -- > Greg Black > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message