Improve the Job API comment for ready field

Author: mimowo

api/openapi-spec/swagger.json

@@ -459,7 +459,7 @@
             "type": "string"
           },
           "ready": {
-            "description": "The number of pods which have a Ready condition.",
+            "description": "The number of active pods which have a Ready condition and are not terminating (without a deletionTimestamp).",
             "format": "int32",
             "type": "integer"
           },

api/openapi-spec/v3/apis__batch__v1_openapi.json

@@ -537,7 +537,8 @@ type JobStatus struct {
 	// +optional
 	Terminating *int32
 
-	// The number of active pods which have a Ready condition.
+	// The number of active pods which have a Ready condition and are not
+	// terminating (without a deletionTimestamp).
 	// +optional
 	Ready *int32
 

pkg/apis/batch/types.go

@@ -595,8 +595,8 @@ type JobStatus struct {
 	// +optional
 	UncountedTerminatedPods *UncountedTerminatedPods `json:"uncountedTerminatedPods,omitempty" protobuf:"bytes,8,opt,name=uncountedTerminatedPods"`
 
-	// The number of pods which have a Ready condition.
-	// +optional
+	// The number of active pods which have a Ready condition and are not
+	// terminating (without a deletionTimestamp).
 	Ready *int32 `json:"ready,omitempty" protobuf:"varint,9,opt,name=ready"`
 }