Improve kubectl built-in help

[Parkofadown]

This is an umbrella issue to manage improvement requests in single issue.

Tasks

Preview Give feedback

1. Improvement for k8s.io/docs/reference/kubectl/generated/kubectl_cordon/
2. Improvement for k8s.io/docs/reference/kubectl/generated/kubectl_events/
3. Improvement for k8s.io/docs/reference/kubectl/generated/kubectl_kustomize/
4. Improvement for k8s.io/docs/reference/kubectl/generated/kubectl_label/
5. Improve behavior of kubectl options

[k8s-ci-robot]

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

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-sigs/prow repository.

[sftim]

Please bear https://kubernetes.io/docs/reference/kubectl/generated/kubectl_cordon/#auto-generated-edit-notice in mind @Parkofadown

We can transfer the issue for you to the right place (Prow command /transfer kubectl) if you like.

[sftim]

/sig cli

[Parkofadown]

Please bear https://kubernetes.io/docs/reference/kubectl/generated/kubectl_cordon/#auto-generated-edit-notice in mind @Parkofadown

We can transfer the issue for you to the right place (Prow command /transfer kubectl) if you like.

@sftim Thank you , what is a Prow command /transfer kubectl ?

[sftim]

We have a bot to help us manage issues. It's sufficiently advanced that I can:
/transfer kubectl

[sftim]

/sig docs
/area kubectl documentation

[k8s-ci-robot]

@sftim: The label(s) area/documentation cannot be applied, because the repository doesn't have them.

In response to this:

/sig docs
/area kubectl documentation

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-sigs/prow repository.

[sftim]

@Parkofadown this issue has a new URL now, but it's still in a way the “same” issue

[ardaguclu]

This is a doc improvement which is a good thing
/triage accepted
/priority backlog
@Parkofadown would you like to open a PR?

[Parkofadown]

This is a doc improvement which is a good thing /triage accepted /priority backlog @Parkofadown would you like to open a PR?

@ardaguclu I would love to open a PR but I do not know your timeline for improvement. I currently work full-time 7:30AM - 3:30 PM EST and provide for 5 people in my household after that.

[ardaguclu]

Also this #1634

[sftim]

/retitle Improve kubectl built-in help

[ardaguclu]

and this #1639

[ah8ad3]

I suggest if you agree we can make this good first issue, for some one that wants to fix them.

[sftim]

Umbrella issues don't make good first issues; see https://www.kubernetes.dev/docs/guide/help-wanted/#good-first-issue

[Parkofadown]

I don't agree that this is a good first issue. Someone would have to know how to program a terminal and be very careful to not make a mistake