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)----