Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 29 Jan 2002 20:48:15 -0800
From:      Gregory Sutter <gsutter@zer0.org>
To:        Michael Lucas <mwlucas@blackhelicopters.org>
Cc:        Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG
Subject:   Re: Practicalities of FAQ->Handbook migrations
Message-ID:  <20020130044815.GY5234@klapaucius.zer0.org>
In-Reply-To: <20020128050724.B93827@blackhelicopters.org>
References:  <20020121140800.A54903@blackhelicopters.org> <20020121215313.K18715@clan.nothing-going-on.org> <20020121174711.A56388@blackhelicopters.org> <20020127115139.GU5234@klapaucius.zer0.org> <20020128050724.B93827@blackhelicopters.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--8VKnE9k7k7imdYv5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On 2002-01-28 05:07 -0500, Michael Lucas <mwlucas@blackhelicopters.org> wro=
te:
> On Sun, Jan 27, 2002 at 03:51:39AM -0800, Gregory Sutter wrote:
> >
> > I understand the need for such an index document.  There is a wealth of
> > FreeBSD information in the FAQ, Handbook, Committer's Guide, articles,
> > books, manual pages, O'Reillynet articles, Daemon News articles,
> > hardcopy books, graphics, ascii art, and also a few hundred web sites,
> > some of it very difficult to find despite its potential utility to many
> > FreeBSD users.
> >=20
> > The Documentation Project seems the logical organization to provide an
> > index of pointers to and within these resources.  Instead of "jumbo
> > FAQ", though, perhaps the FreeBSD Documentation Index would be a better,
> > and sufficiently pretentious, name.  Is this the kind of thing you were
> > talking about, Michael?
>=20
> Something like that, yes.  I would say we should only link to our own
> documents, for reasons pointed out elsewhere in this thread.  Although
> I have a vested interest in onlamp.com, I don't want to maintain an
> index linking to them, BSDzine, daemonnews, etc, etc, etc.

So you're saying that you don't want to be
<http://dmoz.org/Computers/Software/Operating_Systems/Unix/BSD/>?

By the way, only partially blame me for the content there.  DMOZ is
_barely_ an "Open" directory, as the editorial rules are draconian.
In fact, I've once again lost my editor bit, because I didn't make
an edit in 60 days... I don't think I'll ask for it back this time.

> Once we gain experience in indexing our own docs, we could expand it
> to other sites, but let's start small.  :) Once we do that we'd need
> some infrastructure to automatically notice and find bad links, for

Link checkers are available in the ports collection.  Starting small
(local docs) is a good idea.

Greg
--=20
Gregory S. Sutter                   Only two things are infinite, the
mailto:gsutter@zer0.org             universe and human stupidity, and I'm
http://www.zer0.org/~gsutter/       not sure about the former.
hkp://wwwkeys.pgp.net/0x845DFEDD                - Albert Einstein

--8VKnE9k7k7imdYv5
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Comment: ''

iD8DBQE8V3sPIBUx1YRd/t0RAmexAJ4yfu9+g0rseAvK9pnP8VxLF3z4NgCaAxIt
1TJO7A8TUf8HmBEQKaPebSc=
=rIM3
-----END PGP SIGNATURE-----

--8VKnE9k7k7imdYv5--

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?20020130044815.GY5234>