diff --git a/releasenotes/source/newton.rst b/releasenotes/source/newton.rst
index 3dc36265ff..df1ae37e4f 100644
--- a/releasenotes/source/newton.rst
+++ b/releasenotes/source/newton.rst
@@ -3,7 +3,7 @@ Next release: Newton
 ====================
 
 User visible changes
-====================
+~~~~~~~~~~~~~~~~~~~~
 
 * Command-Line Interface Reference abandons the "openstack" command
   reference in favor of the reference in the OpenStackClient repository.
@@ -13,14 +13,30 @@ User visible changes
 
 * Configuration Reference supports the Application Catalog service.
 
-Internal changes
-================
+API guides
+~~~~~~~~~~
 
 * The API reference documentation has been moved from the api-site
-  repository to project specific repositories.
+  repository to project specific repositories. The collection of API docs
+  is now available on the `API Quick Start page <http://developer.openstack.org/api-guide/quick-start/>`_.
+
+* The `Compute API <http://developer.openstack.org/api-ref/compute/>`_ and
+  `DNS API <http://developer.openstack.org/api-ref/dns/>`__ sites offer great
+  examples of the new API reference, maintained by the project team rather
+  than a central docs team.
+
+* Updated the `Contributor Guide <http://docs.openstack.org/contributor-guide/api-guides.html>`__
+  to include specific API Guides information.
+
+* Completed `API Documentation <http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html>`__
+  guidelines with the API Working Group.
+
+Internal changes
+~~~~~~~~~~~~~~~~
 
 * The Operations Guide is now using RST as source format.
 
 * The content of the separate repositories operations-guide and
   ha-guide has been moved into the openstack-manuals repository. The
   repositories operations-guide and ha-guide have been retired.
+