Common Way of Referring to Tekton Resources

[danielhelfand]

This same issue is being discussed in the CLI, and I wanted to raise a similar issue here. Tekton resources should be referred to in a consistent way whenever used in a way that an end user will see:

An example is TaskRun in reconciler/taskrun.go:

TaskRun

pipeline/pkg/reconciler/taskrun/taskrun.go

Line 98 in 84368ae

c.Logger.Errorf("Error retrieving TaskRun %q: %s", name, err)

taskRun

pipeline/pkg/reconciler/taskrun/taskrun.go

Line 110 in 84368ae

c.Logger.Warnf("TaskRun %s createTimestamp %s is after the taskRun started %s", tr.GetRunKey(), tr.CreationTimestamp, tr.Status.StartTime)

taskrun

pipeline/pkg/reconciler/taskrun/taskrun.go

Line 115 in 84368ae

c.Logger.Infof("taskrun done : %s \n", tr.Name)

My personal preference would be for using one word (i.e. TaskRun as opposed to task run) and to also capitalize the resource like so: TaskRun, PipelineRun, PipelineResource.

This would also apply to single word resources like Task and Pipeline as far as capitalizing.

I think this should also apply to documentation surrounding Tekton as well.

Very open to other formats around this, but I do think there should be consistency across all projects with regard to this.

[danielhelfand]

/kind documentation
/kind cleanup

[tekton-robot]

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.
If this issue is safe to close now please do so with /close.

/lifecycle stale

Send feedback to tektoncd/plumbing.

[tekton-robot]

Rotten issues close after 30d of inactivity.
Reopen the issue with /reopen.
Mark the issue as fresh with /remove-lifecycle rotten.

/close

Send feedback to tektoncd/plumbing.

[tekton-robot]

Stale issues rot after 30d of inactivity.
Mark the issue as fresh with /remove-lifecycle rotten.
Rotten issues close after an additional 30d of inactivity.
If this issue is safe to close now please do so with /close.

/lifecycle rotten

Send feedback to tektoncd/plumbing.

[tekton-robot]

@tekton-robot: Closing this issue.

In response to this:

Rotten issues close after 30d of inactivity.
Reopen the issue with /reopen.
Mark the issue as fresh with /remove-lifecycle rotten.

/close

Send feedback to tektoncd/plumbing.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.