Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 15 May 1999 15:31:46 +1000
From:      Greg Black <gjb-freebsd@gba.oz.au>
To:        Nik Clayton <nik@nothing-going-on.demon.co.uk>
Cc:        freebsd-doc@FreeBSD.ORG
Subject:   Re: FDP Directory Reorganisation 
Message-ID:  <19990515053146.27873.qmail@alice.gba.oz.au>
In-Reply-To: <19990513211458.B70767@catkin.nothing-going-on.org>  of Thu, 13 May 1999 21:14:58 %2B0100
References:  <19990513211458.B70767@catkin.nothing-going-on.org> 

next in thread | previous in thread | raw e-mail | index | archive | help
>    Migrate to a new directory structure that follows this layout;
>     doc/
>         <lang>/
>                <charset>/
>                          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 <gjb@acm.org>



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?19990515053146.27873.qmail>