reference-docs icon indicating copy to clipboard operation
reference-docs copied to clipboard

Kubectl generated docs page contains deprecated flags

Open mpuckett159 opened this issue 1 year ago • 5 comments

It looks like something has broken for the kubectl docs generation scripting. There is currently at least one flag (I need to investigate further to determine if there are more) for the run subcommand that has been deprecated since 1.24, and is no longer listed in the kubectl help text, or in the kubectl source code. The page can be found here. I can help out if someone points me to what is generating this page. I also see the yaml here listing it, too.

mpuckett159 avatar Nov 17 '23 21:11 mpuckett159

Actually, I'm more inclined to drop the old way to generate the kubectl reference which is based on a docker image that was not maintained. We could instead generate kubectl reference using the gen-comp command. The output is pure markdown, so it is more in line with the whole k8s website. I did that and proposed a PR to k8s website. The PR wasn't approved yet. Maybe you can help review it and see if there are things to do there.

tengqm avatar Nov 18 '23 08:11 tengqm

I'll reach out to Brian to discuss since I've worked with him on some kubectl things. I think he would probably be fine with this, just may not be aware. Thank you for pointing me to this.

mpuckett159 avatar Nov 18 '23 09:11 mpuckett159

I left a comment on the PR related to this issue. https://github.com/kubernetes/website/pull/42664#issuecomment-1830637341

brianpursley avatar Nov 28 '23 20:11 brianpursley

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Mark this issue as fresh with /remove-lifecycle stale
  • Close this issue with /close
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale

k8s-triage-robot avatar Feb 26 '24 20:02 k8s-triage-robot

The Kubernetes project currently lacks enough active contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Mark this issue as fresh with /remove-lifecycle rotten
  • Close this issue with /close
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle rotten

k8s-triage-robot avatar Mar 27 '24 21:03 k8s-triage-robot

The Kubernetes project currently lacks enough active contributors to adequately respond to all issues and PRs.

This bot triages issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Reopen this issue with /reopen
  • Mark this issue as fresh with /remove-lifecycle rotten
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/close not-planned

k8s-triage-robot avatar Apr 26 '24 22:04 k8s-triage-robot

@k8s-triage-robot: Closing this issue, marking it as "Not Planned".

In response to this:

The Kubernetes project currently lacks enough active contributors to adequately respond to all issues and PRs.

This bot triages issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Reopen this issue with /reopen
  • Mark this issue as fresh with /remove-lifecycle rotten
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/close not-planned

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.

k8s-ci-robot avatar Apr 26 '24 22:04 k8s-ci-robot