better

Author: Richard Jones

doc/admin_guide.txt

@@ -2,7 +2,7 @@
 Administration Guide
 ====================
 
-:Version: $Revision: 1.5.2.2 $
+:Version: $Revision: 1.5.2.3 $
 
 .. contents::
 
@@ -105,30 +105,24 @@ take:
     python run_tests.py
 
 2. If you're using an RDBMS backend, make a backup of its contents now.
-3. Copy your tracker home to a new directory.
-
-Now, working in that copied tracker home:
-
-1. Follow the steps in the `upgrading documentation`_ for the new version of
+3. Make a backup of the tracker home itself.
+4. Stop the tracker web and email frontends.
+5. Follow the steps in the `upgrading documentation`_ for the new version of
    the software in the copied.
-2. Test each of the admin tool, web interface and mail gateway using the new
-   version of the software. To do this, invoke the scripts directly in the
-   source directory with::
+6. You may test each of the admin tool, web interface and mail gateway using
+   the new version of the software. To do this, invoke the scripts directly
+   in the source directory with::
 
     PYTHONPATH=. python roundup/scripts/roundup_server.py <normal arguments>
     PYTHONPATH=. python roundup/scripts/roundup_admin.py <normal arguments>
     PYTHONPATH=. python roundup/scripts/roundup_mailgw.py <normal arguments>
 
-Once you're comfortable that the upgrade will work using that copy, you
-should upgrade the live version:
-
-1. Stop the production web and email frontends.
-2. Perform the upgrade steps on the existing tracker directory.
-3. Upgrade the software::
+7. Once you're comfortable that the upgrade will work using that copy, you
+   should the installed software::
 
     python setup.py install
 
-4. Restart your tracker.
+8. Restart your tracker web and email frontends.
 
 If something bad happens, you may reinstate your backup of the tracker and
 reinstall the older version of the sofware using the same install command::