diff --git a/src/site/xdoc/article3_0.xml b/src/site/xdoc/article3_0.xml
index 7e4a6fdf6..2c00d6e03 100644
--- a/src/site/xdoc/article3_0.xml
+++ b/src/site/xdoc/article3_0.xml
@@ -32,12 +32,14 @@ limitations under the License.
 <p>Lang is now Java 5 based. We've generified the API, moved certain APIs to support <code>varargs</code> and thrown out any features 
 that are now supported by Java itself. We've removed the deprecated parts of the API and have also removed some features that 
 were deemed weak or unnecessary. All of this means that Lang 3.0 is not backwards compatible. </p>
-<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side with your previous version of Lang without any bad side effects. The new package name is the exciting and original <code>org.apache.commons.lang3</code>. </p>
+<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side with your previous version of Lang without any bad side effects. The new package name is the exciting and original <code>org.apache.commons.lang3</code>. This also forces you to recompile your code, making sure the compiler can let you know if a backwards incompatibility affects you. </p>
 <p>As you'd expect, there are also new features, enhancements and bugs fixed. </p>
 </section>
+<!--
 <section name="The build">
 <p>We built 3.0 using Maven 2.2.1 and Java 1.5. <strong>Needs confirmation before release of actual build details</strong></p>
 </section>
+-->
 <section name="Migrating from 2.x">
 <h3>Java code</h3>
 <p>Despite the label of backwards incompatibility, in the vast majority of cases the simple addition of a <code>'3'</code> to an import statement will suffice for your migration. </p><br/>
@@ -46,6 +48,7 @@ were deemed weak or unnecessary. All of this means that Lang 3.0 is not backward
 <p><code>groupId</code>: <code>commons-lang</code> -&gt; <code>org.apache.commons</code></p>
 <p><code>artifactId</code>: <code>commons-lang</code> -&gt; <code>commons-lang3</code></p>
 </section>
+
 <section name="What's gone?">
 <h3>Enum package</h3>
 <p>Java 5 provided enums out of the box, therefore we dispensed with both the deprecated enum package, 
@@ -76,31 +79,31 @@ we will remove the related methods in Lang 4.0. </p>
 <section name="New packages">
 <p>Two new packages have shown up. org.apache.commons.lang3.concurrent, which unsurprisingly provides support classes for 
 multi-threaded programming, and org.apache.commons.lang3.text.translate, which provides a pluggable API for text transformation. </p>
-TODO: Add examples
+<!-- TODO: Add examples -->
 </section>
-<section name="New classes">
-<p><code>CharSequenceUtils</code></p>
-<p><code>EnumUtils</code></p>
-<p><code>JavaVersion</code></p>
-<p><code>Pair</code></p>
-<p><code>Range</code></p>
-<p><code>builder.Builder</code></p>
-<p><code>exception.ContextedException</code></p>
-<p><code>exception.CloneFailedException</code></p>
-<p><code>reflect.ConstructorUtils</code></p>
-<p><code>reflect.FieldUtils</code></p>
-<p><code>reflect.MethodUtils</code></p>
-<p><code>reflect.TypeUtils</code></p>
-<p><code>text.WordUtils</code></p>
-</section>
-<section name="New methods">
+<section name="New classes + methods">
+<p>There are many new classes and methods in Lang 3.0 - the most complete way to see the changes is via this <a href="lang2-lang3-clirr-report.html">Lang2 to Lang3 Clirr report</a>. </p>
+<p>Here is a summary of the new classes: </p>
+<ul>
+<li><code>AnnotationUtils</code></li>
+<li><code>CharSequenceUtils</code></li>
+<li><code>EnumUtils</code></li>
+<li><code>JavaVersion</code> - used in SystemUtils</li>
+<li><code>Pair</code></li>
+<li><code>Range</code> - replaces the old math.*Range classes</li>
+<li><code>builder.Builder</code></li>
+<li><code>exception.ContextedException</code></li>
+<li><code>exception.CloneFailedException</code></li>
+<li><code>reflect.ConstructorUtils</code></li>
+<li><code>reflect.FieldUtils</code></li>
+<li><code>reflect.MethodUtils</code></li>
+<li><code>reflect.TypeUtils</code></li>
+<li><code>text.WordUtils</code></li>
+</ul>
 </section>
 
-<section name="What's changed?">
-  <p>Add info about SystemUtils moving over to the JavaVersion enum and away from int/float. </p>
-</section>
-
-<section name="What's fixed?">
+<section name="Bugfixes?">
+<p>See the <a href="changes-report.html#3.0">3.0 changes report</a> for the list of fixed bugs and other enhancements. </p>
 </section>
 
 <!--