diff --git a/pkg/api/types.go b/pkg/api/types.go
index 673d5c77..bab3aa3e 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/generated.proto b/pkg/api/v1/generated.proto
index 72dcb102..0e5d150e 100644
--- a/pkg/api/v1/generated.proto
+++ b/pkg/api/v1/generated.proto
@@ -138,8 +138,8 @@ message AzureFileVolumeSource {
   optional bool readOnly = 3;
 }
 
-// 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.
 message Binding {
   // Standard object's metadata.
   // More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
diff --git a/pkg/api/v1/types.go b/pkg/api/v1/types.go
index 1e5d2bef..3f4ac4ac 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.
diff --git a/pkg/api/v1/types_swagger_doc_generated.go b/pkg/api/v1/types_swagger_doc_generated.go
index 228a34ff..69b72e44 100644
--- a/pkg/api/v1/types_swagger_doc_generated.go
+++ b/pkg/api/v1/types_swagger_doc_generated.go
@@ -95,7 +95,7 @@ func (AzureFileVolumeSource) SwaggerDoc() map[string]string {
 }
 
 var map_Binding = map[string]string{
-	"":         "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.",
 	"metadata": "Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata",
 	"target":   "The target object that you want to bind to the standard object.",
 }