[Zope] Which docs am I missing?

Martijn Pieters mj@antraciet.nl
Tue, 19 Oct 1999 15:36:34 +0200


At 15:06 19/10/99 , Stefan Hoffmeister wrote:

>It seems as if I am missing quite a bit of documentation. I have
>
>   DTML, ZAG, ZCMG, ZDG
>
>(just the archive names) and tried to read about everything that is
>relevant to "plain" DTML (seems to be limited to DTML, ZCMG).
>
>But then I run into
>
>   "Zope Quick Reference"
>
>which is quite massive and all very fine - the problem just is: where is
>the more elaborate counter-part to this *quick* reference, with all the
>explanations?

This is because the named Documents mostly describe DTML tags. You could 
compare this with a manual on JavaScript, just the language (the if 
statement, how to declare a function, etc.) or Java. At this moment there 
is very scarce documentation on the objects tat make up the Zope framework. 
This is being addressed by DC, and the ZQR does a fair job of listing a 
lost of methods on a lot of objects. For now however, most of us consult 
the source. Methods that do not start with a _ can be used from DTML.

Looking through the source isn't necessarily time consuming. Python is very 
very readable, it is almost pseudo code. Try it once.

--
Martijn Pieters, Web Developer
| Antraciet http://www.antraciet.nl
| Tel: +31-35-7502100 Fax: +31-35-7502111
| mailto:mj@antraciet.nl http://www.antraciet.nl/~mj
| PGP: http://wwwkeys.nl.pgp.net:11371/pks/lookup?op=get&search=0xA8A32149
------------------------------------------