Updates from review comments from Ryan.

diff --git a/docs/en/rst/upgrading/index.rst b/docs/en/rst/upgrading/index.rst
index 937fdaeea3ab58b08070f3c09e9205f7ae01032f..138c1d260de7bca35b8b70e327284a9cfdc240ab 100644 (file)
--- a/docs/en/rst/upgrading/index.rst
+++ b/docs/en/rst/upgrading/index.rst
@@ -13,3 +13,4 @@ Upgrading Bugzilla
    migrating-from-cvs
    migrating-from-a-tarball
    upgrading-with-a-tarball
+   upgrading-customizations

diff --git a/docs/en/rst/upgrading/overview.rst b/docs/en/rst/upgrading/overview.rst
index e779caf5222f8829b9e1a21f4292cdbe90eae18f..c23cd071037aebfd411dfed3d1c7832f084f9f88 100644 (file)
--- a/docs/en/rst/upgrading/overview.rst
+++ b/docs/en/rst/upgrading/overview.rst
@@ -23,9 +23,9 @@ Before Git, we used to use Bazaar and, before that, CVS. If your installation
 of Bugzilla consists of a checkout from one of those two systems, you need to
 upgrade in three steps:
 
-1. upgrade to the latest point release of your current Bugzilla version;
-2. move to Git while staying on exactly the same release;
-3. upgrade to the latest Bugzilla using the instructions for :ref:`upgrading-with-git`.
+1. Upgrade to the latest point release of your current Bugzilla version.
+2. Move to Git while staying on exactly the same release.
+3. Upgrade to the latest Bugzilla using the instructions for :ref:`upgrading-with-git`.
 
 See :ref:`migrating-from-bazaar` or :ref:`migrating-from-cvs` as appropriate.
 
@@ -38,12 +38,15 @@ If you aren't sure which of these categories you fall into, to find out which
 version control system your copy of Bugzilla recognizes, look for the
 following subdirectories in your root Bugzilla directory:
 
-* :file:`.git`: you installed using Git - follow :ref:`upgrading-with-git`
-* :file:`.bzr`: you installed using Bazaar - follow :ref:`migrating-from-bazaar`
-* :file:`CVS`: you installed using CVS - follow :ref:`migrating-from-cvs`
-* none of the above: you installed using an old tarball - follow
-  :ref:`migrating-from-a-tarball`
+* :file:`.git`: you installed using Git - follow :ref:`upgrading-with-git`.
+* :file:`.bzr`: you installed using Bazaar - follow :ref:`migrating-from-bazaar`.
+* :file:`CVS`: you installed using CVS - follow :ref:`migrating-from-cvs`.
+* None of the above: you installed using an old tarball - follow
+  :ref:`migrating-from-a-tarball`.
 
 It is also possible, particularly if your server machine does not have and
 cannot be configured to have access to the public internet, to upgrade using
 a tarball. See :ref:`upgrading-with-a-tarball`.
+
+Whichever path you use, you may need help with
+:ref:`upgrading-customizations`.

diff --git a/docs/en/rst/upgrading/upgrading-customizations.rst b/docs/en/rst/upgrading/upgrading-customizations.rst
new file mode 100644 (file)
index 0000000..c99c6a9
--- /dev/null
+++ b/docs/en/rst/upgrading/upgrading-customizations.rst
@@ -0,0 +1,20 @@
+.. _upgrading-customizations:
+
+Upgrading a Customized or Extended Bugzilla
+###########################################
+
+If your Bugzilla has been customized or uses extensions, you will need to
+make your customizations or extensions work with your new version of Bugzilla.
+If this is the case, you are particularly strongly recommended to do a test
+upgrade on a test system and use that to help you port forward your
+customizations.
+
+If your extension came from a third party, look to see if an updated version
+is available for the version of Bugzilla you are upgrading to. If not, and
+you want to continue using it, you'll need to port it forward yourself.
+
+If you are upgrading from a version of Bugzilla earlier than 3.6 and have
+extensions for which a newer version is not available from an upstream source,
+then you need to convert them. This is because the extension format changed
+in version 3.6. There is a file called :file:`extension-convert.pl` in the
+:file:`contrib` directory which may be able to help you with that.