[ZWeb] Developer Documentation comments

[mindlace]

Paul wrote this:

Documentation

  What's New

    o (2000/09/12) Shane Hathaway has a first cut at a totally
overhauled 
    PythonProductTutorial.

    o (2000/09/12) Brian Lloyd has a document at dev.zope.org regarding 
    <a
href="
http://dev.zope.org/Wikis/DevSite/Projects/DeclarativeSecurity/ZopeSecurityForDevelopers
">Zope
security for developers</a>.  The document says it "serves as a security
primer for Zope component developers".</p>

    o (2000/09/11) Tres added <a 
    href="/project/models/ptk_base/index.html">UML models</a> for 
    Portal Content.

    o (2000/09/11) Unit testing has become a key issue.  Interested in 
    UnitTestingForZopeDevelopers?  This How To courtesy of Chris 
    McDonough.

    o (2000/09/11) The <a href="/project/api/">!APIMaterial</a> for Zope 
    is now at the G2 Developer Home site.

  Tasks

    o Integrate everything at "developer resources",
    http://www.zope.org/Documentation/Developer.  Some of these, like
    acquisition, are easy, as they come from stx sources in Zope.
    They just need reviewing.  These include:

      o Acquisition, ExtensionClass, Persistence, 

  Links

    o CodingStandards

    o Want to debug Zope?  Don't miss:

      - "Zope Debugging",
http://www.zope.org/Documentation/Misc/DEBUGGING.txt.

      - "The Debugger Is Your Friend",
      http://www.zope.org/Members/michel/HowTos/TheDebuggerIsYourFriend.

      - Ken Manheimer's "Debugging Zope Code",
      http://www.zope.org/Members/klm/debuggingzope.

      - A really, really handy How To from Chris McDonough on
      "Postmortem Debugging in Zope",
      http://www.zope.org/Members/mcdonc/HowTos/pm-debug.

      - Who could ever forget the "Python debugger documentation",
      http://www.python.org/doc/current/lib/module-pdb.html?

    o Jim's excellent papers:

      - "ZODB paper",
      http://www.zope.org/Members/jim/Info/IPC8/ZODB3/index.html.

      - There are some updates in a "ZODB presentation",
      http://www.zope.org/Members/jim/zodbhtml/zodb.htm.

    o Andrew Kuchling's "ZODB material",
    http://starship.python.net/crew/amk/zodb/.  Particularly his
    excellent "introduction to using ZODB from Python",
    http://starship.python.net/crew/amk/zodb/.

    o Content manager, DTML, SQL, and developer guide at "official
    guide material", http://www.zope.org/Documentation/Guides/.

    o "ZODB UML models",
    http://www.zope.org/Documentation/Developer/Models/ZODB.

    o Various "developer documentation",
    http://www.zope.org/Documentation/Developer.  This includes 

    o "InterfacesWiki",
    http://www.zope.org/Members/michel/Projects/Interfaces/.  This is
    the point of entry for crafting a formal *interfaces* model for
    Zope and documenting the public interfaces.

    o Brian and Amos' chapter for QuickPython, Brian's DevShed
    article, and Amos' xml.com (and other) articles

  Introductory Material

    Michel Pelletier and Amos Latteier have an O'Reilly contract for
    "Zope: The Definitive Guide",
    http://www.zope.org/Members/michel/ZB.  The book will pass the
    halfway point next week.  The material is aimed at users and mild
    developers.

    Brian Lloyd wrote what remains as the "premier developer intro",
    http://www.devshed.com/Server_Side/Zope/Intro/.

    Amos Latteier wrote an "article for WebTechniques",
    http://www.webtechniques.com/archives/1999/02/latteier/.  This
    article is from Feb 1999, shortly after 'Bobo + Principia = Zope'.
    It provides an overview of Zope from a developer and architect
    perspective.

    Amos and Brian co-authored a chapter in the *QuickPython* book.
    The chapter covers "Bobo programming",
   
http://classic.zope.org:8080/Documentation/Reference/ObjectPublishingIntro

    Amos has also written a series of articles for 'XML.com'.  There
    is a "page of listing his articles",
    http://www.xml.com/pub/au/Latteier_Amos.

      o "Creating XML Applications With Zope",
      http://www.xml.com/pub/1999/12/zope/index.html.  Zope is an open
      source Python-based web application server. Amos Latteier,
      author of Zope's XML support, shows how to use it to create
      simple XML-based applications.

      o "Scripting Zope With XML-RPC",
      http://www.xml.com/pub/2000/01/xmlrpc/index.html. Examining how
      the Zope application server uses XML-RPC to allow remote
      scripting of objects via the Web.

      o "Using Zope as an XML-RPC Client",
      http://www.xml.com/pub/2000/01/xmlrpc/index3.html.

      o "Using Zope as an XML-RPC Server",
      http://www.xml.com/pub/2000/01/xmlrpc/index2.html.

      o "Advanced XML Applications in Zope",
      http://www.xml.com/pub/2000/02/23/zope/index.html. Concluding
      his three-part tutorial on XML and Zope, Amos Latteier discusses
      the wider implications of creating XML applications with Zope,
      demonstrating with the creation of an RSS channel class.