diff --git a/releasenotes/source/mitaka.rst b/releasenotes/source/mitaka.rst
index 536dad01b3..b9504047cf 100644
--- a/releasenotes/source/mitaka.rst
+++ b/releasenotes/source/mitaka.rst
@@ -1,42 +1,63 @@
+==============
 Mitaka release
-~~~~~~~~~~~~~~
+==============
 
-* Tracking of release notes in `doc/releasenotes/` directory.
+* Tracking of release notes in the ``doc/releasenotes/`` directory.
 
 Configuration Reference
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
-* RST conversion completed.
-* Message service (zaqar) is documented.
+* Completed RST conversion.
+* Documented Message service (zaqar).
 
-HA Guide
---------
+High Availability Guide
+~~~~~~~~~~~~~~~~~~~~~~~
 
-* Shared File Systems chapter added.
+* Added the `Highly available Shared File Systems API <http://docs.openstack.org/ha-guide/storage-ha-manila.html>`_
+  section.
+
+* Improved `Pacemaker/Corosync cluster <http://docs.openstack.org/ha-guide/controller-ha-pacemaker.html>`_
+  installation and configuration details.
+
+* Documented the `Pacemaker cluster manager <http://docs.openstack.org/ha-guide/intro-ha-arch-pacemaker.html>`_
+  and `Keepalived architecture <http://docs.openstack.org/ha-guide/intro-ha-arch-keepalived.html>`_
+  details and limitations.
+
+* Added the `MariaDB Galera cluster <http://docs.openstack.org/ha-guide/controller-ha-galera.html>`_
+  installation, configuration, and management details.
+
+* Improved the `RabbitMQ section <http://docs.openstack.org/ha-guide/controller-ha-rabbitmq.html>`_.
 
 Operations Guide
-----------------
+~~~~~~~~~~~~~~~~
 
-* Shared File Systems chapter added.
+* Added the Shared File Systems chapter.
 
 Virtual Machine Image Guide
----------------------------
-
-* RST conversion finished.
-
-Command-Line Interface Reference
---------------------------------
-
-* RST conversion finished.
-
-Architecture Design Guide
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 * Completed RST conversion.
 
+Command-Line Interface Reference
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Completed RST conversion.
+
+Architecture Design Guide
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* Completed RST conversion.
+
+API Guides
+~~~~~~~~~~
+
+* Swagger files now built to http://developer.openstack.org/
+* Created templates for writing API guides for projects teams available
+  in projects repositories.
+
 Translations
-------------
+~~~~~~~~~~~~
 
 * Japanese
 
-  * Publish networking guide as draft.
+  * Published the Networking Guide.