feat: add examples to --help output for admin.go file

[akagami-harsh]

• added exmples to admin.go
• updated the docs
• Resolves one tasks in Add examples to commands' --help output #15690
• https://github.com/argoproj/argo-cd/tree/a93477277/cmd/argocd/commands/admin/admin.go#L44

[codecov]

Codecov Report

Attention: 1 lines in your changes are missing coverage. Please review.

Comparison is base (51b4b20) 49.55% compared to head (a5bd7ec) 49.55%.
Report is 4 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master   #16030   +/-   ##
=======================================
  Coverage   49.55%   49.55%           
=======================================
  Files         269      269           
  Lines       46892    46892           
=======================================
  Hits        23237    23237           
  Misses      21374    21374           
  Partials     2281     2281           

Files	Coverage Δ
cmd/argocd/commands/admin/admin.go	15.33% <ø> (ø)
cmd/argocd/commands/project.go	0.00% <0.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ishitasequeira]

LGTM!

[ChristianCiach]

I am so confused by this PR... The examples advertise a bunch of commands that just don't exist.

For example:

argocd admin cluster list

The command argocd admin cluster has no subcommand list.

Similarly, there is no argocd admin cluster add, argocd admin cluster remove and so on. There isn't even a argocd admin project to call argocd admin project list on.

The same is true for many, many other examples added to argocd admin.

I also cannot find any references to the mentioned commands inside the source code.

I am using this version of the CLI, but as far as I can see, the commands mentioned in the examples of argocd admin didn't exist for a very long time (possibly ever):

$ argocd version
argocd: v2.10.7+b060053.dirty
  BuildDate: 2024-04-15T12:31:44Z
  GitCommit: b060053b099b4c81c1e635839a309c9c8c1863e9
  GitTreeState: dirty
  GoVersion: go1.22.2
  Compiler: gc
  Platform: linux/amd64
argocd-server: v2.10.7+b060053
  BuildDate: 2024-04-15T08:45:08Z
  GitCommit: b060053b099b4c81c1e635839a309c9c8c1863e9
  GitTreeState: clean
  GoVersion: go1.21.3
  Compiler: gc
  Platform: linux/amd64
  Kustomize Version: v5.2.1 2023-10-19T20:13:51Z
  Helm Version: v3.14.3+gf03cc04
  Kubectl Version: v0.26.11
  Jsonnet Version: v0.20.0

Really, I would probably suggest to completely revert the whole PR. At least 90% of the added examples are bogus. I am new to ArgoCD and the example make it hard for me to learn the CLI.

[crenshaw-dev]

@ChristianCiach I'm guessing this was just ChatGPT garbage then. I'll clean it up.

[crenshaw-dev]

@akagami-harsh lmk if I'm wrong, but otherwise... yikes.

[crenshaw-dev]

#17924

[akagami-harsh]

@crenshaw-dev, omg i am so sorry 😔, i should have tested it before making a PR, deeply regret it now 😔. again i am so sowwy for the trouble i caused @ChristianCiach. I'm working on fixing the problem and will submit a follow-up PR as soon as possible. In the meantime, please let me know if there's anything I can do to help minimize any disruption this may have caused.

[crenshaw-dev]

@akagami-harsh no worries, we cleaned it up. If you'd like to submit a PR adding docs for argocd admin commands that exist, I'd happily review.