# HG changeset patch
# User hodgestar
# Date 1287355996 0
# Node ID ae7022ade5ccc922633e2ac15e894d7e73ef38e2
# Parent  fc9955ec8c67b5212923e4e07fc20fe3bfa2636f
Add documentation section on reporting upgrade issues.

diff --git a/doc/upgrade.txt b/doc/upgrade.txt
--- a/doc/upgrade.txt
+++ b/doc/upgrade.txt
@@ -51,6 +51,19 @@
 .. [#] http://bitten.edgewall.org/browser/trunk/contrib/deletebuild.py
 
 
+Reporting Upgrade Issues
+========================
+
+Debugging upgrade issues can be difficult since the Bitten development team
+does not have access to your database.  Attaching a description of your
+database schema before and after running `trac-admin upgrade` to your
+request for assistance may help others diagnose the problem more swiftly.
+
+You can create such a schema description using Gerald_ or a similar tool.
+
+.. [gerald] http://pypi.python.org/pypi/gerald
+
+
 Upgrade history
 ===============