A comment to the paragraph below was recently added via 
http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/AppendixB.stx#1-0

---------------

  This reference describes the interfaces to the most common set of
  basic Zope objects.  This reference is useful while writing DTML,
  Perl, and Python scripts that create and manipulate Zope objects.

    % Anonymous User - June 20, 2002 6:55 pm:
     This section needs a Table of Contents too.

    % Anonymous User - June 26, 2002 1:43 pm:
     The reference describes nearly nothing when you don't know the solution! 
     Examples are absolutely necessary.

    % Anonymous User - July 12, 2002 3:32 pm:
     i agree.

    % Anonymous User - July 14, 2002 5:21 am:
     Strongly disagree.  This is a reference, not a tutorial or explanatory 
text.

    % Anonymous User - Aug. 20, 2002 11:13 pm:
     A reference doesn't contain explanatory text?

    % Anonymous User - Nov. 12, 2003 10:52 am:
     Look at http://www.php.net : it's both a precise API reference for PHP 
developers, and a tutorial full of
     interesting samples.
     Apart from the Zope Book (which efficiently sums up the ZMI) I have rarely 
seen such a poor pedagogical and
     practical approach as among the zope documentation.

    % Anonymous User - Nov. 12, 2003 8:18 pm:
     As a Zope User, imaging my surprise to see this page referenced in the W3C 
Validator service's tip of the day
     for further information on how to implement a page redirect instead of a 
page refresh (see
     http://www.w3.org/QA/Tips/reback ). What a kudo from the industry! Imagine 
my disappointment at landing on
     this mess of bickering commentary as well as no discussion or TOC for 
finding syntax for redirection. I think
     a lot of people following the link and unaware of Zope would click 'back' 
pretty quickly with a lees than
     positive impression. FWIW, Duke

    % Anonymous User - Dec. 11, 2003 12:43 am:
     I agree with the comments suggesting that a table of contents (and an 
index too perhaps) would enhance the
     value of this API reference. I also agree that some code snippets showing 
proper usage and some explanatory
     notes would help to make this API reference more useful.
     I come from a Java background.

    % Anonymous User - Dec. 24, 2003 1:55 am:
     So convoluted! So frustrating! It would be much more useful to have this 
information organized in a more
     hierarchical fashion, like Python's Global Module Index (c.f.
     http://www.python.org/doc/current/modindex.html)

    % Anonymous User - Jan. 18, 2004 5:46 am:
     For the love of god, someone please listen to these suggestions.

     1) Table of contents / index
     2) General organization (php.net, 
http://www.python.org/doc/current/modindex.html) 
     3) Example code.

     One of greatest things that the PHP community has going for it is a clear, 
concise, organized reference, WITH
     EXAMPLES. Newbies get rolling instantly, and advanced users are able to 
skip to exactly what they're looking
     for.

    % edcass - Jan. 18, 2004 7:24 pm:
     man, I stopped developing in Zope 2 years ago... I thought this would have 
been dealt with by now. Well, I
     suppose I'll finish this project off and then check back in in another 2 
years. See you then...

    % furiag - Mar. 1, 2004 5:12 am:
     This API reference is uncompleted. It doesn´t include commands like 
     manage_clone or manage_delObjects. I guess there are a lot more.

    % furiag - Mar. 1, 2004 5:52 am:
     For a quick reference visit the Zope Documentation project at
     http://zdp.zope.org/ZQR

    % furiag - Mar. 1, 2004 6:24 am:
     For a complet reference on APIs (advise: it's huge and you can easily get 
lost), 
     download http://zdp.zope.org/download/ArchetypesAPIDoc.zip

    % slinkp - Sep. 7, 2004 7:19 pm:
     Table of Contents is coming!

     ... and a whole lot of additions and fixes, too.
     I'm working on it as part of the Zope Book 2.7 edition.
     Help would be welcome from experienced Zoperators. It's a big job.
     Read the in progress version 
"here":http://www.plope.com/Books/2_7Edition/AppendixB.stx

     Other chapters need volunteers too.  See
     "the sign-up page":http://www.plope.com/Books/zb_signup

    % slinkp - Jan. 27, 2005 1:35 am:
     we really ought to disable commenting while the 2.7 edition is in progress.
     at this point it's not helpful, it's a spam magnet.

    % Anonymous User - May 22, 2005 2:02 pm:
     you're right. go use PHP. or JAVA. "Verily I say unto you, They have their 
reward." (Mt 6.2) HA HA HA

    % inflatables - Oct. 16, 2005 11:04 pm:
     i agree.
     -----
     my inflatables china site
     http://www.inflatables-china.net

    % Anonymous User - Apr. 1, 2006 11:25 am:
     I want mp3 player. What will advise?

    % Anonymous User - Apr. 5, 2006 5:06 pm:
     Hi
     To write the letter, it is necessary ...

    % Anonymous User - Apr. 10, 2006 12:09 pm:
     Thank you for being generous with your resources... I hope that you will 
receive more than you need for your
     time and
     energy. Keep at work!

    % Anonymous User - Apr. 20, 2006 1:55 pm:
     hi
     Why I can not insert the image into my message?

    % Anonymous User - Apr. 30, 2006 2:39 pm:
     Great page, not too fancy but well balanced! Cheers!

    % Anonymous User - May 12, 2006 4:12 pm:
     Tell, and here at you always so?

    % Anonymous User - May 19, 2006 6:25 pm:
     Hi! What you do today by evening?

    % Anonymous User - May 20, 2006 5:42 am:
     Hi, why nobody responds me?

    % Anonymous User - May 20, 2006 6:46 am:
     Hi
     As to me to create the same page?

    % Anonymous User - May 29, 2006 9:17 am:
     Help to choose a videocamera. What standard to choose?

    % Anonymous User - May 29, 2006 12:00 pm:
     Help to choose a videocamera. What standard to choose?

    % Anonymous User - July 19, 2006 7:53 pm:
     Great new site about mature mom <a 
href="http://www.xxxmom.info/sexymilf10.html";>sexy milf 10</a>. Millions
     pics and movies t2}</a>!

    % Anonymous User - July 19, 2006 8:45 pm:
     <a href="http://www.games-slots-2006.info/ 
">http://www.games-slots-2006.info/ </a>, <a
     href="http://www.games-slots-2006.info/gamblblackj.html";>gambling 
blackjack slots</a>

    % Anonymous User - Aug. 3, 2006 1:50 pm:
     Hi
     Just wanted to thank you guys for uploading such a smooth loading, 
informative site.
     <a 
href="http://www.homedecor-store.info";>http://www.homedecor-store.info</a>

    % Anonymous User - Sep. 1, 2006 7:02 pm:
     Great new site about hot teens <a 
href="http://www.hotteenie.info/teenboyspub.html";>teen boys puberty</a>.
     Millions pics and movies <a 
href="http://www.hotteenie.info/asianteenblowj.html";>asian teen blowjob</a>!

    % Anonymous User - Sep. 17, 2006 12:45 pm:
     Hi all! This is a great porno site: <a 
href="http://www.hot-amateur.info/grannysexamatteen.html";>granny sex
     amateur teen video</a> look this hardcore action: <a
     href="http://www.hot-amateur.info/hannvidsexamatlukesexyjok.html";>hannah 
video sex amateur luke sexy
     jokes</a> ))

    % Anonymous User - Sep. 22, 2006 4:15 am:
     <a href="http://www.game-slots.info/ ">http://www.game-slots.info/ </a>, <a
     href="http://www.game-slots.info/rulefor.html";>rule for playing craps</a>

    % Anonymous User - Sep. 22, 2006 2:29 pm:
     <a href="http://www.super-casino1.info/ ">http://www.super-casino1.info/ 
</a>, <a
     href="http://www.super-casino1.info/onlineroulette.html";>online roulette 
gambling</a>

    % Anonymous User - Oct. 2, 2006 10:54 pm:
     Hi, people!! Great new site about anal sex. 
     <a href="http://www.hotanalmovies.info/asseaters.html";>ass eaters 
galleries</a>
     The youngest, freshest and hardest porn for FREE! Updates Everyday!
     <a href="http://www.hotanalmovies.info/asiantight.html";>asian tight ass</a>
     Best porno pics and video !!! All category, millions movies and photos !!!
     <a href="http://www.hotanalmovies.info/asstraffjasm.html";>ass traffic 
jasmine lynn</a>

    % Anonymous User - Oct. 3, 2006 2:19 am:
     Aphrodite love ... <a 
href="http://www.fantasy-amateur.info/freeliveteensexvidandsampl.html";>free 
live teen
     sex videos and samples</a> and hotty girlsss:<a
     href="http://www.fantasy-amateur.info/freenudeamatpictandvideo.html";>free 
nude amateur pictures and video
     free</a> yes yes yes!!! <a 
href="http://www.fantasy-amateur.info/freenudecelebs.html";>free nude celebs 
movie
     amateur fuck</a>
_______________________________________________
ZDP maillist  -  ZDP@zope.org
http://mail.zope.org/mailman/listinfo/zdp

Reply via email to