[Zope] Zope Book: UniqueValuesFor

[jpenny@universal-fasteners.com]

On Thu, Dec 21, 2000 at 11:03:21PM +0100, Milos Prudek wrote:
> Regarding the upcoming Zope Book:
> 
> There are some examples for UniqueValuesFor method and "_usage" syntax
> (it looks that only values "range:min", "range:max" and "range:min:max"
> are possible), but these are not mentioned in the DTML reference or API
> reference. Maybe Zope Book needs a ZCatalog reference, if there are
> methods like UniqueValuesFor...
> 
> I would recommend that since the current Zope Book is a giant leap
> forward, these and any other language tricks that are scattered in the
> Zope Book chapters should be briefly mentioned in the ZopeBook DTML and
> API references.
> 
> IMHO there are many people like me who:
> 
> - are trying to start using Zope BECAUSE OF the final availability of
> Zope Book
> - for various reasons are not very comfortable with hunting information
> around zope.org and in Zope sources (no permanent internet connection is
> a strong reason)
> - consequently expect to find all basic information in coherent form in
> Zope Book

Wonderful goals, but...
the problem that I see is that Zope contains so much and can be used in
so many ways that any book is simutaneously too limited and out of date.

Think of the technologies that Zope already embraces, DTML, python,
some XML, XML-RPC, DAV, ftp, http, HTML, SQL, LDAP, CVS, Zcatalog.  
I counted 14 SQL database adapters, alone, and I am sure I missed some.

Add in technologies coming on line such as perl, SOAP, ZPatterns, ZEO, 
CORBA, COM and others.

Add major application packages  like Squishdot, OIO, ZopeGUM, zCommerce,
etailer and others.

And this misses some biggies including on the fly graph and visual
generation.  Assuming that each can be suitable discussed in an average
of 100 pages, we have at least 22 * 100 = 2200 pages.  Books this size 
just don't fly.  (They really hurt when dropped on your foot, too).


> 
> Obviously, Zope Book can't contain everything. I like the sentence "this
> is an advanced topic and it's outside the scope of this book". Authors
> have put limits to what they want to achieve. I wish that the ZB is
> coherent in the "explanation - example - reference" trio.

That is a great sentence.  Unfortunately, it is completely misleading in 
this context.  The problem is not so much what is too advanced, but what is
too basic or too specialized.  From what I have seen on the list, most newbies 
know too little HTML, too little SQL, and too little python.
(Newbies shouldn't be mucking with Zope internals, these are the things
that are 'too advanced').

But, this comes from a particular view of the elephant, one which sees
Zope as an quick web application framework.  This is hardly the only view.

I use Zope in a particular way, emphasizing HTML, DTML, python,
SQL.  It is not at all being used the way that DC intended, yet because
Zope flexibly integrates a great deal of basic technology, it can be used
reasonably well to do what I want it to do.  This is a good measure of
great technology.

Don't forget that there are 252 HowTos and 83 Quick tips in addition
to the Zope Book, the Guides, and API reference.  All of these can
be dowloaded to your computer.  You do not need a full time connection.
(And they are all bundled so that you do not have to download them one 
at a time!)

Zope is never going to be easy to learn.  There is just too much.  Yet,
Zope is not hard to begin, and the Zope Book is about making it easier
to begin.  As such, the encyclopedic detail that you are requesting is
not only unneeded; it is harmful, it gives the impression to the reader
that enormous knowledge is needed to use Zope.  This is not true.

Begin to use Zope.  Find out what it enables you to do easily.  When you
hit the hard patches, look at the tips and howtos.  Only then log onto the net.
Search Zope.org. Use the mailing list.  When you get an answer, think hard.  
Bit by bit, enlightenment will occur.  You will never know all of Zope, 
but it will become easier and easier to do harder and harder things.

And, the first six weeks are killers, the next six are a pleasure, and
then you start to regret all that you could have done better.  It is
much like the rest of life!


Jim Penny

> 
> 
> --
> Milos Prudek
> 
> 
> 
> _______________________________________________
> 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 )
>