[Zope] Quickstart needs updating!

[Jeff Sasmor]

Fellow Zopistas:

Just a note (although this begins to sound
like a rant as I read it back, sorry!) to mention how
surprised I was that even given the revamped Zope
look n feel in 2.3.x, the "Quickstart" seems to
still need a lot of updating!

Isn't it likely that the first thing a newbie would do
is read this and get really confused?  There are
a plethora of new concepts and especially new
terms that have no definitions almost anywhere
without a lot of looking around.

Now anyone who has used Zope for a while
and/or is familiar with the history of product
development at DC will know some of this stuff,
but it just adds to the confusion for new users.
Some examples:

>>>In App development/External Methods:
   "Pluggable brains" (sounds cool but daunting)

>>>In The Almighty Lever
  "An exiting new development being worked on for Zope is The Lever... "

  (I have been working with Zope for well over a year and
   still don't know what THIS is....)

 "Tabula or Aqueduct "
   (You have to dig deep to figure out what these are)


>>>In Adding Object Behavior to Relational Data
    " With Zope and Aqueduct "
   "Aqueduct Database Methods"


>>> In "Programming Data with Tabula"

    This talks some more about Aqueduct and Tabula.

    Again, Tabula is defined exactly nowhere, as a
    matter of fact, if you search for Tabula on Zope.org
   all you get is a footnote on this page.
  http://www.zope.org/Documentation/Guides/ZSQL-HTML/ZSQL.1.5.5.html

     Aqueduct isn't mentioned too much on Zope.org either:
 just in these two places, and they don't help much...
 http://www.zope.org/Products/DA/ZODBCDA/CHANGES.txt
http://www.zope.org/Members/paul/BusinessDecision


>>>In "Dropin Objects"
  Here we see mention of the "Aqueduct line of products" ..... nuff said on
this one.
  And Confera:  this could be changed to something newer, I was under the
impression that
  Confera was sort of obsolete.


>>>In "High Performance" and "Multi-Platform" and "SQL and HTML in Harmony"
and
      "Multiple Data Sources" and "Multi-tiered" and "Publish Databases"
   More mentions of Aqueduct.

  "Multi-tiered" and "Databases"  each has a figure that shows a block
called Principia.  Now you can find stuff about this
  on Zope.org, but it's scantly explained for such a key part of the system.

And so on.

Summary: Quickstart Really Needs to Get Updated

Jeff Sasmor
jeff@sasmor.com
Check out http://www.naggle.com/