Subject: Re: NetBSD Documentation Framework - how to do it
To: None <>
From: Hiroki Sato <>
List: netbsd-docs
Date: 12/12/2006 17:18:48
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

"Mike M. Volokhov" <> wrote
  in <>:

mi> Greetings!
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

Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

Version: GnuPG v1.4.2 (FreeBSD)