diff --git a/README.rst b/README.rst
index 9a231d9..4a02bce 100644
--- a/README.rst
+++ b/README.rst
@@ -7,8 +7,12 @@ Openstack API Working Group documents
This repository contains documents from the OpenStack API working group,
including guidelines and proposed rules concerning API consistency, naming
-conventions, and best practice recommendations.
+conventions, and best practice recommendations. The published
+information can be found at `specs.openstack.org
+`_.
Interested in contributing to the API conversations? Simply clone this
-repository and follow the [OpenStack code and review submission
-processes](http://docs.openstack.org/infra/manual/developers.html).
+repository and follow the `OpenStack code and review submission
+processes `_
+and the `process document
+`_.