diff --git a/docs/api/migrating-to-09.xml b/docs/api/migrating-to-09.xml
index 7256852980..4ebd81ab2b 100644
--- a/docs/api/migrating-to-09.xml
+++ b/docs/api/migrating-to-09.xml
@@ -3,7 +3,7 @@
                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
 ]>
-<section id="migrating-to-09">
+<chapter id="ref-migrating">
   <title>Migrating from NetworkManager 0.8 to NetworkManager 0.9</title>
 
   <para>
@@ -154,4 +154,4 @@
 
   </section>
 
-</section>
+</chapter>
diff --git a/docs/api/network-manager-docs.xml b/docs/api/network-manager-docs.xml
index 4381bb56f0..869177cc8a 100644
--- a/docs/api/network-manager-docs.xml
+++ b/docs/api/network-manager-docs.xml
@@ -111,14 +111,7 @@
     </section>
   </chapter>
 
-  <chapter id="ref-migrating">
-    <title>Migrating from Previous Versions of NetworkManager</title>
-    <para>
-      This part describes changes you need to make in programs that
-      use older versions of NetworkManager.
-    </para>
-    <xi:include href="migrating-to-09.xml" />
-  </chapter>
+  <xi:include href="migrating-to-09.xml" />
 
   <index>
     <title>Index</title>