[ZWeb] Zope.org feedback: Zope Documentation
Mon, 15 Apr 2002 08:49:01 -0400
Both of these points are discussed at the page I forwarded around yesterday:
Trevor Toenjes wrote:
> I agree about the Python connection.
> This should be inluded in the primary description of zope on the zope.org
> homepage with a link to http://python.org/
> And I agree that the The Zope Book needs to include headings in each Chapter
> to make the index and search more granular. I dont know if this is an issue
> for the current project. Paul?
>>From: email@example.com [mailto:firstname.lastname@example.org]On Behalf
>>Of alan runyan
>>Sent: Sunday, April 14, 2002 3:55 PM
>>To: Paul Everitt; james whitcomb (via www.zope.org)
>>Cc: Zope.org Mailinglist
>>Subject: Re: [ZWeb] Zope.org feedback: Zope Documentation
>>sorry to step in. but i have a strong opinion on this topic.
>>>Before starting, could you give me a listing of the five things you like
>>>most about the documentation at the PHP site, along with some URLs? It
>>>will be a little be apples-and-oranges, though: your needs from the PHP
>>>site are more advanced than your needs from the Zope site.
>>I would like to pipe up. People come to ZOPE thinking its a
>>PHP. It is not. It uses Python.
>>Most people have not heard of python. We need to make them
>>in 2 sentences or less.
>>If you look at the PHP manual, it looks similiar to the Python Manual.
>>Because... well, they are both *languages*.
>>Turning to the ZOPE Book. Which you basically have to read an entire
>>chapter. because there are no further units besides chapters.
>>to find out about metal:block. for instance, how do they do
>>that? read the
>>entire PageTemplates chapter?
>>I have always wanted to see a Zope version of:
>>compare those layouts to: http://www.zope.org/Documentation/ZopeBook/
>>I have always wanted to goto a screen and see *all the pagetemplate* tal
>>directives or metal directives.
>>this doesnt really exist. and what does exist is lost in WikiMadness.
>>>We're making a big push to better organize the large amount of Zope
>>>documentation. We could use some input from someone new to the site.
>>I dont think it takes someone new to ZOPE. One of the reasons I
>>do so much
>>w/ zopelabs is because I need a place to put things I commonly use. It
>>itself has fallen into disorganization and only if you are persistent or
>>know how to search it (me, for instance) -- can you really go directly to
>>>To answer your question, have you seen the Zope Book and Zope Developer
>>>Perhaps that is more information than you are looking for.
>>I dont think its *more* information than he is looking for. its just the
>>sections are not broken up into any smaller sections. for instance
>>tal/metal directives. or all the dtml tags. or SESSIONS. speaking of
>>SESSIONs, try this: how many clicks does it take to find out how
>>variables from a SESSION object?
>>now I urge you to goto http://www.php.net/manual/en/ and try to find
>>information about SESSION handling.
>>this I believe is a perfect experiment to find out how the typical person
>>Zope-web maillist - Zopeemail@example.com