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 --