diff --git a/api/openapi-spec/swagger.json b/api/openapi-spec/swagger.json
index ff0b18e74a6..aa2dcb98c51 100644
--- a/api/openapi-spec/swagger.json
+++ b/api/openapi-spec/swagger.json
@@ -46918,7 +46918,7 @@
     }
    },
    "io.k8s.kubernetes.pkg.api.v1.Binding": {
-    "description": "Binding ties one object to another. For example, a pod is bound to a node by a scheduler.",
+    "description": "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.",
     "required": [
      "target"
     ],
diff --git a/api/swagger-spec/v1.json b/api/swagger-spec/v1.json
index eb07fbf68ea..7cee7941a2f 100644
--- a/api/swagger-spec/v1.json
+++ b/api/swagger-spec/v1.json
@@ -17327,7 +17327,7 @@
   "models": {
    "v1.Binding": {
     "id": "v1.Binding",
-    "description": "Binding ties one object to another. For example, a pod is bound to a node by a scheduler.",
+    "description": "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.",
     "required": [
      "target"
     ],
diff --git a/docs/api-reference/v1/definitions.html b/docs/api-reference/v1/definitions.html
index 431dfd23752..c4efeaa73d0 100755
--- a/docs/api-reference/v1/definitions.html
+++ b/docs/api-reference/v1/definitions.html
@@ -8071,7 +8071,7 @@ Examples:<br>
 <div class="sect2">
 <h3 id="_v1_binding">v1.Binding</h3>
 <div class="paragraph">
-<p>Binding ties one object to another. For example, a pod is bound to a node by a scheduler.</p>
+<p>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.</p>
 </div>
 <table class="tableblock frame-all grid-all" style="width:100%; ">
 <colgroup>
@@ -10112,7 +10112,7 @@ Examples:<br>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2017-06-06 04:24:44 UTC
+Last updated 2017-06-08 02:30:43 UTC
 </div>
 </div>
 </body>
diff --git a/pkg/api/v1/generated.proto b/pkg/api/v1/generated.proto
index 4843f48f055..b3f8a58d6f6 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_swagger_doc_generated.go b/pkg/api/v1/types_swagger_doc_generated.go
index 228a34ffa44..69b72e445a3 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.",
 }