diff --git a/html/up2to3.html b/html/up2to3.html
index 871d72ec88ee4a6e39cd24310d5b29f90d6765d8..b62a9f491dcac9fb83dea502f6261c07e0d4e05c 100644
--- a/html/up2to3.html
+++ b/html/up2to3.html
@@ -74,6 +74,18 @@ a <tt>OWLAPIAlignment</tt> so it may be necessary to change it as well.</p>
   required ontology and a <tt>loadInit( URI )</tt> method that will
   load the initial alignment.</p>
 
+<h2>Manipulating your alignment</h2>
+
+<p>If you manipulated the alignment through the attributes
+  (<tt>onto1</tt> and <tt>onto2</tt>), you must now explicitely cast
+  them as <tt>(OWLOntology)onto1</tt> because they are now declared
+  as <tt>Object</tt>.</p>
+
+<h2>Misc.</h2>
+
+<p><tt>JWNLDistance.Initialize()</tt> now throws an <tt>AlignmentException</tt>... you
+  must do something with it.</p>
+
 <h2>Report to us</h2>
 
 <p>Please report any tweak that we did not mention here so that we can