diff --git a/doc/source/index.rst b/doc/source/index.rst
index 2b4bf35..a14d394 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -38,7 +38,6 @@ permits.
    specs/deploy-ci-dashboard
    specs/jenkins-job-builder_2.0.0-api-changes
    specs/nodepool-drivers
-   specs/pholio
    specs/ptgbot
    specs/puppet-module-functional-testing
    specs/refstack_dot_org
@@ -124,6 +123,7 @@ implemented, they have been abandoned.
    specs/logs-in-swift
    specs/maniphest
    specs/nodepool-launch-workers
+   specs/pholio
 
 Specifications Repository Information
 =====================================
diff --git a/specs/pholio.rst b/specs/pholio.rst
index b2b5bec..ac652cd 100644
--- a/specs/pholio.rst
+++ b/specs/pholio.rst
@@ -6,6 +6,16 @@
   Unported License.
   http://creativecommons.org/licenses/by/3.0/legalcode
 
+.. note::
+
+   Much of this spec, including the puppet deployment, was
+   implemented.  However the Pholio host has been deprecated and
+   removed as of July 2017 due to changing circumstances.
+
+   See also
+
+   * `<http://lists.openstack.org/pipermail/openstack-dev/2017-June/118275.html>`__
+   * `<https://review.openstack.org/#/c/477386/>`__
 
 ===========================
 Pholio Service Installation