diff --git a/docs/scaling/DEVELOPMENT.md b/docs/scaling/DEVELOPMENT.md
index a9a420afdbe7..17318ea93973 100644
--- a/docs/scaling/DEVELOPMENT.md
+++ b/docs/scaling/DEVELOPMENT.md
@@ -26,6 +26,8 @@ In the Reserve state, the Revision has no scheduled Pods and consumes no CPU.  T
 
 In the Retired state, the Revision has provisioned resources.  No requests will be served for the Revision.
 
+Note: Retired state is currently not set anywhere. See [issue 1203](https://github.com/knative/serving/issues/1203).
+
 ## Context 
 
 ```
diff --git a/pkg/apis/serving/v1alpha1/revision_types.go b/pkg/apis/serving/v1alpha1/revision_types.go
index f019db31361c..554f55489b31 100644
--- a/pkg/apis/serving/v1alpha1/revision_types.go
+++ b/pkg/apis/serving/v1alpha1/revision_types.go
@@ -71,6 +71,7 @@ const (
 	// anymore. It should not have any Istio routes or Kubernetes resources.
 	// A Revision may be brought out of retirement, but it may take longer than
 	// it would from a "Reserve" state.
+	// Note: currently not set anywhere. See https://github.com/knative/serving/issues/1203
 	RevisionServingStateRetired RevisionServingStateType = "Retired"
 )