diff --git a/pkg/api/types.go b/pkg/api/types.go
index 673d5c7769c..bab3aa3ee29 100644
--- a/pkg/api/types.go
+++ b/pkg/api/types.go
@@ -3135,7 +3135,8 @@ type NamespaceList struct {
 	Items []Namespace
 }
 
-// Binding ties one object to another - for example, a pod is bound to a node by a scheduler.
+// Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+// Deprecated in 1.7, please use the bindings subresource of pods instead.
 type Binding struct {
 	metav1.TypeMeta
 	// ObjectMeta describes the object that is being bound.
diff --git a/pkg/api/v1/types.go b/pkg/api/v1/types.go
index 1e5d2bef473..3f4ac4ac933 100644
--- a/pkg/api/v1/types.go
+++ b/pkg/api/v1/types.go
@@ -3593,8 +3593,8 @@ type NamespaceList struct {
 	Items []Namespace `json:"items" protobuf:"bytes,2,rep,name=items"`
 }
 
-// Binding ties one object to another.
-// For example, a pod is bound to a node by a scheduler.
+// Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
+// Deprecated in 1.7, please use the bindings subresource of pods instead.
 type Binding struct {
 	metav1.TypeMeta `json:",inline"`
 	// Standard object's metadata.