[Zope] The new DTML syntax

Anthony Pfrunder s341625@student.uq.edu.au
Tue, 10 Aug 1999 08:31:11 +1000 (GMT+1000)


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