From owner-freebsd-doc  Sat Aug 26 07:15:30 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id HAA19058
          for doc-outgoing; Sat, 26 Aug 1995 07:15:30 -0700
Received: from time.cdrom.com (time.cdrom.com [192.216.222.226])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id HAA19052
          for <doc@freefall.FreeBSD.org>; Sat, 26 Aug 1995 07:15:26 -0700
Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.6.11/8.6.9) with SMTP id HAA00119; Sat, 26 Aug 1995 07:15:19 -0700
To: John Fieber <jfieber@grendel.csc.smith.edu>
cc: doc@freefall.FreeBSD.org
Subject: Re: "too many notes" 
In-reply-to: Your message of "Sat, 26 Aug 1995 09:06:08 CDT."
             <199508261406.JAA03926@fieber-john.campusview.indiana.edu> 
Date: Sat, 26 Aug 1995 07:15:19 -0700
Message-ID: <117.809446519@time.cdrom.com>
From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
Sender: doc-owner@FreeBSD.org
Precedence: bulk

> Finally, things can be helped somewhat by providing better
> navigation controls which I will work on (after I figure out some
> cryptic variable names I neglected to document :).  Namely, and a
> line at the top showing where you are:
> 
> FreeBSD Handbook
> Installing FreeBSD : Supported Configurations : Ethernet Cards
> <i>Previous</i>: Disk Controllers
> <i>Next</i>: Miscellaneous

And the Up, right?  Let's not forget the Up. :-)

> > We could also probably stand to collapse some of the chapters together
> > so as to have more material easily accessible in one place, but that's
> > up to John.
> 
> By all means make suggestions as to which! 

OK, I'm going on a general review craze in there soon, so let's see.

I need to also look at the fact that much of
sysinstall/help/<lang>/...  has become part of the handbook!  Argh,
two copies at once and in multiple languages, at that!  That reminds
me, we have no top level switch on the pages for selecting the
language you want them in, but I suppose we can get to that later when
we figure out just what the heck we're going to do with the whole
multi-lingual thing.  It's not exactly a _small_ issue, mind you, and
we've probably put it off a little longer that we should have even
now.  Far better would be to scoop all the sysinstall/help/<lang>/...
files straight into the handbook with the appropriate edits.

Then we can hack a bit on the release tools to stick compressed ascii
versions of the desired manuals on the install floppies.  Sure and as
I'd like to stick the HTML versions on there too, of course, but I
don't think that I'm going to manage to get Lynx on the boot floppy!
Maybe on the root floppy, maybe..  Hmmmmmmm!  :-)

That'd still leave at least a few "intro" docs in ASCII though, just
to tide the user through enough screens to *get* the root floppy
loaded.

					Jordan