Subject: Re: NetBSD Documentation Framework - how to do it
To: None <mishka@NetBSD.org>
From: Hiroki Sato <hrs@NetBSD.org>
Date: 12/12/2006 17:18:48
Content-Type: Text/Plain; charset=us-ascii
"Mike M. Volokhov" <mishka@NetBSD.org> wrote
mi> This is a well known fact that our www (htdocs) is stagnated from
mi> technical POV. Fragile and heavyweight toolchain, content mess,
mi> broken standards - all these discourages developers and users from
mi> further contributions to www and any of guides.
mi> Several people (including me, and thus you can reasonably blame me
mi> for this) has had proposed some ad-hoc solutions in this area.
mi> Two approaches has been mentioned most often:
mi> - cleanup of our DocBook/Website XML based framework
mi> - migration to Wiki
I am one of the people who are concerned about the doc framework, and
this was the reason why I joined the team so I should have been more
active in this area (sorry, all...). Since I have difficulty a bit
in my real job, the cleanup work is going quite slowly.
Anyway, from my investigations about such frameworks in recent years,
I think the problem is maintenability of the documents in a source
form from average developer's point of view. Maintaining the
toolchain is not so complex and I think some of us can do so like we
maintain a compiler in the base system.
I am not sure creating a group for documentation work is effective,
but I think it is good to discuss such a topic with each other.
| Hiroki SATO
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (FreeBSD)
-----END PGP SIGNATURE-----