cli icon indicating copy to clipboard operation
cli copied to clipboard

UX: unify the use of grammatical number for logs and showlog

Open ppitonak opened this issue 5 years ago • 20 comments

Version and Operating System

tkn Version:

0.7.1

Operating System:

Expected Behavior

The same concept is named in the same way

Actual Behavior

Multiple commands have a subcommand logs (plural, e.g. tkn task -h) but subcommand start has a parameter --showlog (singular, e.g. tkn task start -h) which is not user-friendly.

Steps to Reproduce the Problem

Additional Info

ppitonak avatar Feb 17 '20 14:02 ppitonak

Hey @ppitonak

We support tkn task logs and tkn taskrun logs. --showlog is for immediately starting logs after starting a PipelineRun or TaskRun. Are you suggesting that you would like this to be named --logs instead, or just that you would like it to be --showlogs?

danielhelfand avatar Feb 17 '20 14:02 danielhelfand

@danielhelfand I would like to see it renamed to --showlogs

ppitonak avatar Feb 17 '20 14:02 ppitonak

Thanks for your issue , renaming flag is not cheap, as users (+ scripts) may have already using it in the a released version , why do you feel so strong that plural would be more user friendly than singular word ?

chmouel avatar Feb 17 '20 14:02 chmouel

It's my personal preference for --showlogs instead of --showlog but my point is that is should be either singular or plural everywhere.

Is renaming tkn task logs to tkn task log easier?

You can always introduce new one and deprecate the old one (without removing it). IMHO these changes are acceptable while the API is alpha, would be much more difficult when we go beta.

ppitonak avatar Feb 17 '20 15:02 ppitonak

renaming may only occurs over a long period of time deprecation over multiple release, but we could provide an alias if that's something a lot of users are asking.. as you know naming is hard and sometime it's better to just "live with it"

You could always have an alias like tktn_logs if that really something that you need ?

chmouel avatar Feb 17 '20 15:02 chmouel

In general, supporting a log alias for logs subcommands would be really nice.

danielhelfand avatar Feb 17 '20 16:02 danielhelfand

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 avatar Aug 13 '20 12:08 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 avatar Aug 13 '20 12:08 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 avatar Aug 13 '20 12:08 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.

tekton-robot avatar Aug 13 '20 12:08 tekton-robot

/remove-lifecycle rotten

ppitonak avatar Aug 13 '20 15:08 ppitonak

/reopen

ppitonak avatar Aug 13 '20 15:08 ppitonak

@ppitonak: Reopened this issue.

In response to this:

/reopen

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.

tekton-robot avatar Aug 13 '20 15:08 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 avatar Nov 11 '20 15:11 tekton-robot

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

/lifecycle rotten

Send feedback to tektoncd/plumbing.

tekton-robot avatar Dec 11 '20 16:12 tekton-robot

/remove-lifecycle rotten

vdemeester avatar Dec 11 '20 16:12 vdemeester

Issues go stale after 90d of inactivity. Mark the issue as fresh with /remove-lifecycle stale with a justification. 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 with a justification. If this issue should be exempted, mark the issue as frozen with /lifecycle frozen with a justification.

/lifecycle stale

Send feedback to tektoncd/plumbing.

tekton-robot avatar Mar 11 '21 17:03 tekton-robot

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

/lifecycle rotten

Send feedback to tektoncd/plumbing.

tekton-robot avatar Apr 10 '21 17:04 tekton-robot

/remove-lifecycle rotten

This issue is still present in 0.17.1

ppitonak avatar Apr 13 '21 07:04 ppitonak

/lifecycle frozen

vdemeester avatar Apr 13 '21 07:04 vdemeester