--- a/docs/upgrade.rst	Wed Feb 16 12:15:08 2011 +0100
+++ b/docs/upgrade.rst	Sat Feb 19 14:00:01 2011 +0100
@@ -25,6 +25,11 @@
 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
+   any minor or major releases. 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.
 
@@ -33,7 +38,7 @@
 
 ::
 
- 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