[Zope] Comment on comments in DTML

Tom Cameron tom@cameron.to
Wed, 25 Jul 2001 22:16:55 +1000


Toby,
I think that DTML, mostly because of its modular and hierarchical nature, is
deceptively simple, but actually quite powerful.

It is true that most individual methods or documents are simple in
isolation, but within an entire site they represent part of a complex
system.

I find it is this modular nature that, in fact, drives me to want to comment
my code even more. If you are sharing your code or developing in a team, it
can be difficult to drill through many separated methods to understand what
is happening.

I think you can never comment code too much.

Thanks, Tim, for your comments, I was not aware that it had been discussed
before.

Tom.

=>
=> I think one reasonable answer to this is that dtml is not really
=> designed for code. If you have logic expressed in dtml that is
=> non-trivial enough to benefit from commenting, then dtml is probably
=> not the best language to express it in.
=>
=> (all, IMO).
=>
=>
=>
=> Toby Dickenson
=> tdickenson@geminidataloggers.com
=>
=> _______________________________________________
=> Zope maillist  -  Zope@zope.org
=> http://lists.zope.org/mailman/listinfo/zope
=> **   No cross posts or HTML encoding!  **
=> (Related lists -
=>  http://lists.zope.org/mailman/listinfo/zope-announce
=>  http://lists.zope.org/mailman/listinfo/zope-dev )
=>