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

"Mike M. Volokhov" <mishka@NetBSD.org> wrote
  in <20061211135023.GA24056@netbsd.org>:

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

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

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

iD8DBQBFfmXoTyzT2CeTzy0RAsZ9AKCKFcOmTtQ9wW+77FTDXx9yRBVs+wCgtRY5
GbFCSBu07BX8TXnZNe06JAw=
=cIWS
-----END PGP SIGNATURE-----

----Security_Multipart(Tue_Dec_12_17_18_48_2006_918)----