----Security_Multipart(Mon_Jan_30_20_35_50_2006_428)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

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?

 I know many people are not familiar with XML (and XSLT) and want to
 avoid them if possible, but I personally think using DocBook and XML
 is not wrong and the culprit is our poor usage of them.

--
| Hiroki SATO

----Security_Multipart(Mon_Jan_30_20_35_50_2006_428)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (FreeBSD)

iD8DBQBD3foWTyzT2CeTzy0RAo+CAJ9kXfM9CRAf6aBGZaDlXQ/qlm2PCwCghoEZ
+mmwkgMJr9qvQaiXAr/2PNQ=
=SxpN
-----END PGP SIGNATURE-----

----Security_Multipart(Mon_Jan_30_20_35_50_2006_428)----