Date: Thu, 20 May 1999 06:12:16 -0400 (EDT) From: Rob Garrett <eagle@phc.igs.net> To: Greg Black <gjb@acm.org> Cc: Nik Clayton <nik@nothing-going-on.demon.co.uk>, doc@FreeBSD.ORG, freebsd-translate@ngo.org.uk Subject: Re: FDP Directory Reorganisation Message-ID: <Pine.BSF.4.10.9905200611520.67536-100000@eagle.phc.igs.net> In-Reply-To: <19990520095342.18541.qmail@alice.gba.oz.au>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <gjb@acm.org> > > > > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.10.9905200611520.67536-100000>