[Zope-CMF] Suggestion - Modular Documentation

Chris Withers chrisw@nipltd.com
Wed, 04 Jul 2001 19:31:29 +0100


seb bacon wrote:
> 
> ( use StructuredTextNG, not HTML ... )

StructedText, why? I gotta agree with Jon, why come up with another form of
markup language when you have to translate it from there into another one
anyway?!

> In principle it's an excellent idea, but requires a lot of discipline
> by developers and simple, strong, easy to follow documentation
> guidelines / APIs, and a lot of metawork - in other words, someone to
> drive it who's got quite a lot of spare time.  I think this has been a
> problem with ZDP quite often.

...and to be blunt, if that's the case, it'll never happen. People with the
knowledge rarely have time to explain it to people, let alone write it down :-(

cheers,

Chris