diff --git a/README.rst b/README.rst
index 03013c758..f6eb67884 100644
--- a/README.rst
+++ b/README.rst
@@ -1,14 +1,33 @@
 aodh
 ====
 
-Release notes can be read online at:
-  https://docs.openstack.org/aodh/latest/contributor/releasenotes/index.html
+Aodh is the alarming service for OpenStack.
+
+-------------
+Documentation
+-------------
 
 Documentation for the project can be found at:
   https://docs.openstack.org/aodh/latest/
 
-The project home is at:
-  https://storyboard.openstack.org/#!/project/openstack/aodh
+Release notes can be read online at:
+  https://docs.openstack.org/aodh/latest/contributor/releasenotes/index.html
+
+
+Code Repository
+---------------
+
+- Server: https://opendev.org/openstack/aodh/
+
+Bug Tracking
+------------
 
 Bugs and feature requests are tracked on Launchpad at:
-  https://storyboard.openstack.org/#!/project/openstack/aodh
+  https://bugs.launchpad.net/aodh/
+
+IRC
+---
+
+IRC Channel: #openstack-telemetry on `OFTC`_.
+
+.. _OFTC: https://oftc.net/