Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(cli): add examples for argo archive list with option explanations #13662

Merged

Conversation

leehosu
Copy link
Contributor

@leehosu leehosu commented Sep 25, 2024

Fixes #11898

Motivation

Modify the argo archive list command for more information

Modifications

Added examples for the argo archive list command.

Verification

run argo archive list -h

@agilgur5 agilgur5 changed the title docs: Add examples for 'argo archive list' with option explanations docs(cli): add examples for argo archive list with option explanations Sep 25, 2024
@agilgur5 agilgur5 added area/cli The `argo` CLI area/docs Incorrect, missing, or mistakes in docs labels Sep 25, 2024
Copy link
Member

@agilgur5 agilgur5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the contribution. Please try to follow the issue description and it's recommendations closely, see in-line comments below

Verification

Added examples for the argo archive list command.

Verification means checking that these examples work and that the changes are tested / pass CI

v3 Outdated Show resolved Hide resolved
cmd/argo/commands/archive/list.go Show resolved Hide resolved
docs/cli/argo_archive_list.md Show resolved Hide resolved
@agilgur5 agilgur5 added the problem/more information needed Not enough information has been provide to diagnose this issue. label Sep 25, 2024
@agilgur5 agilgur5 removed the problem/more information needed Not enough information has been provide to diagnose this issue. label Sep 25, 2024
Copy link
Member

@agilgur5 agilgur5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some grammar and style changes below, plus more consistency suggestions.

Also you have not yet corrected your "Verification" section, per my previous comment. You should test the example commands you've listed and confirm they work.
Your other PR #13668 does not have a proper "Verification" section either

cmd/argo/commands/archive/list.go Outdated Show resolved Hide resolved
@agilgur5
Copy link
Member

agilgur5 commented Sep 28, 2024

Codegen is failing correctly, you'll need to apply my previous suggestion to the generated CLI docs as well.

I did not mention that initially as that was intended as a learning opportunity for you to figure out on your own. As you've merged main twice for unrelated CI flakes, it seems you might have missed that.

Copy link
Member

@agilgur5 agilgur5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM now, thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/cli The `argo` CLI area/docs Incorrect, missing, or mistakes in docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add examples to commands' --help output
3 participants