On Jan 31, 2007, at 12:42 , David Fetter wrote:

On Tue, Jan 30, 2007 at 03:49:14PM -0500, Andrew Dunstan wrote:

6. they all need proper docs. READMEs and the like are nowhere near good

Agreed.  I'm thinking a new major section in the SGML docs is in order
with a subsection for each contrib/ piece underneath.

I agree re: new section. Are you thinking that all contrib docs would be built automatically, even if the individual extensions (neƩ contrib modules?) aren't installed? I think that would definitely raise awareness of the extensions that are available.

I'd also like to see being able to add docs for non-core extensions (e.g., ip4r) to the main documentation. Not sure what that would involve: rebuilding the tocs and index, besides the new pages themselves? Or perhaps just a rebuild of the complete docs? I haven't had docs building on a local system for a couple of years, so I'm not it a position currently to play around with this, but it's something I'd love to learn how to do.

Michael Glaesemann
grzm seespotcode net

---------------------------(end of broadcast)---------------------------
TIP 5: don't forget to increase your free space map settings

Reply via email to