diff --git a/README.rst b/README.rst
index f0477e2..04c62ff 100644
--- a/README.rst
+++ b/README.rst
@@ -5,6 +5,13 @@
 This repository contains specifications and policies that apply to
 OpenStack as a whole.
 
+.. note:: The OpenStack Cross-Project specification process has been
+          deprecated in favor of `OpenStack-wide Goals
+          <https://governance.openstack.org/tc/goals/index.html>`__ and
+          `OpenStack SIGs <https://wiki.openstack.org/wiki/OpenStack_SIGs>`__.
+          The documents found here are still useful as historical artifacts,
+          but at this time the specifications are not actionable
+
 This work is licensed under a `Creative Commons Attribution 3.0
 Unported License
 <http://creativecommons.org/licenses/by/3.0/legalcode>`__.
diff --git a/doc/source/index.rst b/doc/source/index.rst
index ca3a28c..fa9fde8 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -9,6 +9,13 @@ This work is licensed under a `Creative Commons Attribution 3.0
 Unported License
 <http://creativecommons.org/licenses/by/3.0/legalcode>`__.
 
+.. note:: The OpenStack Cross-Project specification process has been
+          deprecated in favor of `OpenStack-wide Goals
+          <https://governance.openstack.org/tc/goals/index.html>`__ and
+          `OpenStack SIGs <https://wiki.openstack.org/wiki/OpenStack_SIGs>`__.
+          The documents found here are still useful as historical artifacts,
+          but at this time the specifications are not actionable
+
 Specifications
 ==============