Subject: Re: simplifying htdocs build procedure (long term)
To: None <netbsd-docs@netbsd.org>
From: Rui Paulo <rpaulo@fnop.net>
List: netbsd-docs
Date: 01/30/2006 11:41:50
Hiroki Sato <hrs@NetBSD.org> writes:
> Jan Schaumann <jschauma@netmeister.org> wrote
> in <20060129165832.GA4650@netmeister.org>:
>
> js> As you are probably well aware, the way that htdocs works at the moment
> js> is rather complex and requires significant resources. This directly
> js> affects how users and developers contribute to the online documentation
> js> -- or rather, how often they don't! We need to make it easier for
> js> anybody to contribute without having to install a large number of
> js> complex applications from pkgsrc or without having to learn the
> js> intricacies of the build process.
> js>
> js> I'd like to start a detailed discussion about how we can make this
> js> happen. I think we should first figure out what exactly our goals are
> js> in the documentation management framework. Here's what I came up with:
> (snip)
>
> Well, I have some ideas to simplify the current structure as well as
> the build process itself, so I would like to work as a coordinator for
> improving our whole htdocs/ structure with incorporating this discussion.
> Although this sort of discussion is useful, without actual implementation
> we will not reach a consensus and tend to fall into a matter of preference,
> I think. However, it will take some time anyway though htdocs/ needs
> to be up-to-date at any time, so how about making a branch for
> restructuring and discussing this topic with implementing ideas?
Yes, go ahead. Thanks.
--
Rui Paulo - rpaulo@fnop.net