Add description field to spec

This will add a description field to the spec of
pipeline, task pipeline resource ond condition
so that it can be used to provide the description
of these and can also be used by UI to show description

Fix #993

pkg/apis/pipeline/v1alpha1/condition_types.go

@@ -52,6 +52,11 @@ type ConditionSpec struct {
 	// Check declares container whose exit code determines where a condition is true or false
 	Check Step `json:"check,omitempty"`
 
+	// Description is a user-facing description of the condition that may be
+	// used to populate a UI.
+	// +optional
+	Description string `json:"description,omitempty"`
+
 	// Params is an optional set of parameters which must be supplied by the user when a Condition
 	// is evaluated
 	// +optional

pkg/apis/pipeline/v1alpha1/pipeline_types.go

@@ -24,6 +24,10 @@ import (
 
 // PipelineSpec defines the desired state of Pipeline.
 type PipelineSpec struct {
+	// Description is a user-facing description of the pipeline that may be
+	// used to populate a UI.
+	// +optional
+	Description string `json:"description,omitempty"`
 	// Resources declares the names and types of the resources given to the
 	// Pipeline's tasks as inputs and outputs.
 	Resources []PipelineDeclaredResource `json:"resources,omitempty"`

pkg/apis/pipeline/v1alpha2/pipeline_types.go

@@ -52,6 +52,10 @@ func (p *Pipeline) Copy() PipelineInterface {
 
 // PipelineSpec defines the desired state of Pipeline.
 type PipelineSpec struct {
+	// Description is a user-facing description of the pipeline that may be
+	// used to populate a UI.
+	// +optional
+	Description string `json:"description,omitempty"`
 	// Resources declares the names and types of the resources given to the
 	// Pipeline's tasks as inputs and outputs.
 	Resources []PipelineDeclaredResource `json:"resources,omitempty"`

pkg/apis/pipeline/v1alpha2/task_types.go

@@ -55,6 +55,11 @@ func (t *Task) Copy() TaskInterface {
 
 // TaskSpec defines the desired state of Task.
 type TaskSpec struct {
+	// Description is a user-facing description of the task that may be
+	// used to populate a UI.
+	// +optional
+	Description string `json:"description,omitempty"`
+
 	// Resources is a list input and output resource to run the task
 	// Resources are represented in TaskRuns as bindings to instances of
 	// PipelineResources.

pkg/apis/resource/v1alpha1/pipeline_resource_types.go

@@ -93,8 +93,12 @@ type PipelineResourceStatus struct {
 
 // PipelineResourceSpec defines  an individual resources used in the pipeline.
 type PipelineResourceSpec struct {
-	Type   PipelineResourceType `json:"type"`
-	Params []ResourceParam      `json:"params"`
+	Type PipelineResourceType `json:"type"`
+	// Description is a user-facing description of the pipeline resource that may be
+	// used to populate a UI.
+	// +optional
+	Description string          `json:"description,omitempty"`
+	Params      []ResourceParam `json:"params"`
 	// Secrets to fetch to populate some of resource fields
 	// +optional
 	SecretParams []SecretParam `json:"secrets,omitempty"`