Enumerated the possible build phase states in the comment

stevekuznetsov · stevekuznetsov · commit 5bcaa2012eac · 2017-04-06T16:23:26.000-04:00
Signed-off-by: Steve Kuznetsov &lt;skuznets@redhat.com&gt;
diff --git a/api/protobuf-spec/github_com_openshift_origin_pkg_build_api_v1.proto b/api/protobuf-spec/github_com_openshift_origin_pkg_build_api_v1.proto
diff --git a/api/swagger-spec/oapi-v1.json b/api/swagger-spec/oapi-v1.json
@@ -24357,7 +24357,7 @@
     "properties": {
      "phase": {
       "type": "string",
-      "description": "phase is the point in the build lifecycle."
+      "description": "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\"."
      },
      "cancelled": {
       "type": "boolean",
diff --git a/api/swagger-spec/openshift-openapi-spec.json b/api/swagger-spec/openshift-openapi-spec.json
@@ -68293,7 +68293,7 @@
       "type": "string"
      },
      "phase": {
-      "description": "phase is the point in the build lifecycle.",
+      "description": "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
       "type": "string"
      },
      "reason": {
diff --git a/pkg/build/api/types.go b/pkg/build/api/types.go
@@ -228,7 +228,8 @@ type ImageChangeCause struct {
 
 // BuildStatus contains the status of a build
 type BuildStatus struct {
-	// Phase is the point in the build lifecycle.
+	// Phase is the point in the build lifecycle. Possible values are
+	// "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
 	Phase BuildPhase
 
 	// Cancelled describes if a cancel event was triggered for the build.
diff --git a/pkg/build/api/v1/generated.proto b/pkg/build/api/v1/generated.proto
diff --git a/pkg/build/api/v1/swagger_doc.go b/pkg/build/api/v1/swagger_doc.go
@@ -191,7 +191,7 @@ func (BuildSpec) SwaggerDoc() map[string]string {
 
 var map_BuildStatus = map[string]string{
 	"":                           "BuildStatus contains the status of a build",
-	"phase":                      "phase is the point in the build lifecycle.",
+	"phase":                      "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
 	"cancelled":                  "cancelled describes if a cancel event was triggered for the build.",
 	"reason":                     "reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.",
 	"message":                    "message is a human-readable message indicating details about why the build has this status.",
diff --git a/pkg/build/api/v1/types.go b/pkg/build/api/v1/types.go
@@ -170,7 +170,8 @@ type ImageChangeCause struct {
 
 // BuildStatus contains the status of a build
 type BuildStatus struct {
-	// phase is the point in the build lifecycle.
+	// phase is the point in the build lifecycle. Possible values are
+	// "New", "Pending", "Running", "Complete", "Failed", "Error", and "Cancelled".
 	Phase BuildPhase `json:"phase" protobuf:"bytes,1,opt,name=phase,casttype=BuildPhase"`
 
 	// cancelled describes if a cancel event was triggered for the build.
diff --git a/pkg/openapi/zz_generated.openapi.go b/pkg/openapi/zz_generated.openapi.go
@@ -8569,7 +8569,7 @@ var OpenAPIDefinitions *common.OpenAPIDefinitions = &common.OpenAPIDefinitions{
 				Properties: map[string]spec.Schema{
 					"phase": {
 						SchemaProps: spec.SchemaProps{
-							Description: "phase is the point in the build lifecycle.",
+							Description: "phase is the point in the build lifecycle. Possible values are \"New\", \"Pending\", \"Running\", \"Complete\", \"Failed\", \"Error\", and \"Cancelled\".",
 							Type:        []string{"string"},
 							Format:      "",
 						},
