diff --git a/README.rst b/README.rst
index 1b08288..1bae613 100644
--- a/README.rst
+++ b/README.rst
@@ -1,15 +1,17 @@
-=============
+==========
 aodhclient
-=============
+==========
 
 Python bindings to the OpenStack Aodh API
 
-This is a client for OpenStack Aodh API. There's :doc:`a Python API
-<api>` (the :mod:`aodhclient` module), and a :doc:`command-line script
-<shell>` (installed as :program:`aodh`). Each implements the entire
-OpenStack Aodh API.
+This is a client for OpenStack Aodh API. There's a `Python API
+<https://docs.openstack.org/python-aodhclient/latest/api.html>`_ (the
+aodhclient module), and a `command-line script
+<https://docs.openstack.org/python-aodhclient/latest/shell.html>`_ (installed
+as aodh). Each implements the entire OpenStack Aodh API.
 
 * Free software: Apache license
+* Release notes: https://releases.openstack.org/teams/telemetry.html
 * Documentation: https://docs.openstack.org/python-aodhclient/latest/
 * Source: https://git.openstack.org/cgit/openstack/python-aodhclient
 * Bugs: https://bugs.launchpad.net/python-aodhclient