updated docs based on a1c1 feedback

doc/CHANGES.txt

@@ -32,6 +32,11 @@ Zope Changes
 
         o Simpler creation of Python products.
 
+    Unfortunately, there are a number of incompatabilities between
+    Zope and Python 1.5.2 that have been reported but not yet
+    fixed. Zope 2.0 alpha 2, which will be released the week of May
+    26, will fix most or all of these.
+
     ZODB 3
 
       ZODB is the next generation of our object database architecture.
@@ -73,6 +78,10 @@ Zope Changes
 
         - FileStorage packing isn't available yet,
 
+	- OPTIMIZATION: FileStorage will get a more efficient data
+          structure for maintaining index information and key methods
+          in the ZODB framework will move to C.
+
         - Tools to convert ZODB 2 databases to ZODB 3 File
           Storages or import files are needed.
 
@@ -97,6 +106,8 @@ Zope Changes
           This is only a problem when running Zope 2 with multiple
 	  threads.
 	
+	- The default content needs to be provided for the new
+          database format.
 
     ZClasses
 
@@ -140,9 +151,10 @@ Zope Changes
         candidate releases over the next several weeks.
 
         Early releases will support both the ZODB 2 (aka 
-        BoboPOS) and ZODB3.  We may even support ZODB 2 in Zope 2.0
+        BoboPOS) and ZODB 3.  We may even support ZODB 2 in Zope 2.0
         final, but ZODB 2 support will be phased out by Zope 2.1 or
-        sooner. 
+        sooner.  Some features (e.g. the new control panel version
+        manager) may require ZODB 3.
 
   Releases
 

doc/INSTALL.txt

@@ -44,9 +44,34 @@ Choosing your database
 
     - You can use ZODB 3 with the ZopeHTTPServer and the
       PCGI publisher by changing the published module to
-      Zope.  This will only use a single thread, however.
+      Zope. 
   )
 
+Quick Start
+
+  If you are impatient, the following commands should get you up and
+  running with Zope 2 using ZServer and ZODB 3 on Unix::
+
+    python wo_pcgi.py  # Note, this mst be Python 1.5.2
+    python z2.py -d <your dns server>
+
+  where you need to supply the IP address of your dns server to the -d
+  option.  If you get errors indicating that addresses are in use,
+  then you will have to supply arguments to z2.py to change the ports
+  used for HTTP or FTP. (See the help for the z2.py script by
+  running z2.py with the -h option.)
+
+  You can then connect to Zope 2 by directing your browser to::
+
+     http://yourhost:9673/manage
+
+  where yourhost is the name or address of the machine running Zope 2.
+  If you changed the HTTP port with the -w option to z2.py, then use
+  it rather than 9673.  
+
+  You will be prompted for a user name and password, which may
+  be found in the 'access' file in the Zope installation directory.
+
 Building Zope
   
   There are some python scripts in the top-level directory that should