diff --git a/docs/upgrade.rst b/docs/upgrade.rst
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -25,15 +25,20 @@ This will display any changes made from 
 current config. And tries to do an automerge. It's always better to do a backup
 of config file and recheck the content after merge.
 
+.. note::
+   The next steps only apply to upgrading from non bugfix releases eg. from
+   1.1 to 1.2. Bugfix releases (eg. 1.1.2->1.1.3) will not have any database 
+   schema changes or whoosh library updates
+
 It's also good to rebuild the whoosh index since after upgrading the whoosh 
-version there could be introduced incompatible index changes.
+version there could be introduced incompatible index changes. 
 
 
 The last step is to upgrade the database. To do this simply run
 
 ::
 
- paster upgrade-db production.ini
+    paster upgrade-db production.ini
  
 This will upgrade schema, as well as update some default on the database,
 always recheck the settings of the application, if there are no new options