Subject: Re: [lo] Re: NetBSD WWW feedback from firstname.lastname@example.org
To: Hubert Feyrer <email@example.com>
From: David Brownlee <firstname.lastname@example.org>
Date: 11/04/2001 10:43:24
On Tue, 30 Oct 2001, Hubert Feyrer wrote:
> On Tue, 30 Oct 2001, David Brownlee wrote:
> > One option might be to try to pull most of the howtos into the
> > guide and have links directly to the relevant sections...
> I like this idea, but we have to look into how to organize this.
> So far, the guide is in a rather longish, tutorial style explanation.
> In contrast, htdocs/Documentation is usually short answers to various
> questions, FAQ-like.
> While the first is good for starters, the latter is good for experienced
> users, so I see a good reason to keep both. We'd just have to find a way
> to integrate things. Maybe add another part to the Guide, or even start a
> second document besides the guide, and then work out a framework that can
> include both books/parts then. (I'd also like to put a SGMLized version of
> pkgsrc/Packages.txt there somewhen...).
> The fact that updating the guide is a bit more work than just running a
> perl script is a different matter. (Plus I don't know how jade
> etc. generates HTML link points. If it's changing on every creation-run,
> we need to fix that first!)
Would it make sense to have a section at the end of the tutorial
which is the HOWTO, and a link at the start which is 'experienced
users may want to skip directly to the HOWTO'?
David/absolute -- www.netbsd.org: No hype required --