On Mon, 9 Aug 1999, Jim Fulton wrote:
Zope then has to support three variants. This is really unappealing from a documentation and support point of view.
Before the XML stuff comes out I'd like to propose a solution to the documentation problem. My proposition is to create a super-zclass called __builtin__. This ghost-class implements all the built-in tags AND documents them. This could be done by slurping out the doc strings for each tag (assuming each tag is implemented via a class). Hence, the HELP tab in the management screen would always display the most-to-date information on all these wonderful tags. Also, it could describe each of the 1 million forms of dtml syntax. To take it further, why not create a tagmethod which includes a documentation property (see my last big post for the tagmethod concept). Cheers, Anthony Pfrunder