diff --git a/doc/xdocs/navigation.xml b/doc/xdocs/navigation.xml
index 1377018f47..f04744f023 100644
--- a/doc/xdocs/navigation.xml
+++ b/doc/xdocs/navigation.xml
@@ -41,6 +41,7 @@
       <item name="External Web Articles" href="articles.html"/>
       <item name="Products using Acegi" href="powering.html"/>
       <item name="Use without Spring" href="standalone.html"/>
+      <item name="Upgrading to 0.9.0" href="upgrade/upgrade-080-090.html"/>
       <item name="Upgrading to 0.8.0" href="upgrade/upgrade-070-080.html"/>
       <item name="Upgrading to 0.7.0" href="upgrade/upgrade-06-070.html"/>
       <item name="Upgrading to 0.6" href="upgrade/upgrade-05-06.html"/>
diff --git a/doc/xdocs/upgrade/upgrade-080-090.html b/doc/xdocs/upgrade/upgrade-080-090.html
index 244066cbfb..40ac72d7ec 100644
--- a/doc/xdocs/upgrade/upgrade-080-090.html
+++ b/doc/xdocs/upgrade/upgrade-080-090.html
@@ -49,6 +49,9 @@ applications:
 	<li>Event publishing has been refactored. New event classes have been added, and the location of
 	LoggerListener has changed. See the net.sf.acegisecurity.event package.</li>
 		
+	<li>Users of the "authz" taglib will generally need to change the "operation"
+	to "username", as reflection is now used to retrieve the property.</li>
+		
     </ul>
 
 </body>