Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 24 May 2000 15:21:45 -0700
From:      Jim Mock <jim@FreeBSD.org>
To:        Nik Clayton <nik@FreeBSD.ORG>
Cc:        Mark Ovens <mark@dogma.freebsd-uk.eu.org>, doc@FreeBSD.ORG
Subject:   Re: Why no Master Index?
Message-ID:  <20000524152144.A29447@luna.cdrom.com>
In-Reply-To: <20000524084850.A8565@kilt.nothing-going-on.org>; from nik@FreeBSD.ORG on Wed, May 24, 2000 at 08:48:50AM %2B0000
References:  <20000523194307.C233@parish> <20000524084850.A8565@kilt.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 24 May 2000 at 08:48:50 +0000, Nik Clayton wrote:
> On Tue, May 23, 2000 at 07:43:07PM +0100, Mark Ovens wrote:
> > Is there a reason why there is no Master Index/TOC for the FreeBSD
> > docs? 
> 
> This >   < much time.
> 
> This >                         < many things to do.

I'm more than happy to take this on.

> Your example looked good.  Do you want to turn that in to HTML (based
> on the existing contents of www/en), and we can go from there.
> 
> You might want to take a look at http://www.freebsd.org/docs.html,
> and try trimming that down.  One way to do it would be to split things
> in two based on whether or not they're maintained by the project.
> 
> So have a docs/index.html that offers the reader links to the two
> files, and an 'internal.html' that lists the project maintained docs,
> and an 'external.html' that lists the other stuff ('internal' and
> 'external' are crap names, please, come up with better ones :-) )
> 
> I also wouldn't mind seeing a translation table that listed all the
> docs, and an indication of whether or not they've been translated. . . 
> 
>                          en     es     fr    ja    ru    zh
>    Handbook              x             x     x
>    FAQ                   x      x      x     x     x     x
>    FDP Primer            x
>    Porter's Handbook     x                   x
>    [...]
> 
> This would be a separate page.

This sounds good to me too.  I can start throwing something together
today (unless Mark is already on top of it -- and if you are, let me
know so I duplicate efforts :-)

- jim

-- 
- jim mock - walnut creek cdrom/freebsd test labs - jim@luna.cdrom.com -
- phone: 1.925.691.2800 x.3814 - fax: 1.925.674.0821 - jim@FreeBSD.org -
- editor - The FreeBSDzine - www.freebsdzine.org - jim@freebsdzine.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?20000524152144.A29447>