[Kernel-handbook-general] Re: Announcing kernel-handbook project

[dann frazier]

On Fri, 2005-09-09 at 22:54 -0700, Jurij Smakov wrote:
> In an attempt to improve the situation with Debian kernel documentation I 
> have recently initiated the kernel-handbook project on Alioth. The goal of 
> this project is to create and maintain the Debian kernel handbook, a 
> primary access point to all kernel-related user documentation in Debian. 
> At the moment it only contains the description of the new kernel packaging 
> scheme, which kernel team introduced with the upload of 2.6.12 kernel 
> debs. Comments and suggestions regarding the contents are, of course, welcome.


Thanks for doing this Jurij - a quick glance shows some good
information.  I would note that, in my experience, fluid documentation
maintained in source control/docbook presents a barrier to entry for
many potential contributors.  I've migrated most (all?) of such projects
to wikis and have that people are more like to contribute, probably
because its so much easier.  The flexibility/portability of the source
certainly suffers, however - docbook was certainly difficult for me to
give up; but I am glad I did.