Skip to content

Comments

Enhance README/lib.rs with advanced command description examples#215

Open
fadeevab wants to merge 3 commits intogoogle:masterfrom
fadeevab:chore/advanced-description
Open

Enhance README/lib.rs with advanced command description examples#215
fadeevab wants to merge 3 commits intogoogle:masterfrom
fadeevab:chore/advanced-description

Conversation

@fadeevab
Copy link
Contributor

@fadeevab fadeevab commented Feb 16, 2026

Improve documentation with the advanced examples of the top-level command "description" (for the help output).
The short variant of a subcommand is reflected in the documentation and the examples.

NOTE: filename examples/goup.rs (GoUp) is chosen to make the help output compelling via the {command_name} placeholder (maybe go-up.rs?)

@fadeevab
Copy link
Contributor Author

The advanced description and the Examples section have been supported by argh from day one (I discovered this by reading the code many years ago). However, I believe many people don’t know about it, and this is my attempt to fix that.

@fadeevab
Copy link
Contributor Author

@erickt Hi, could you please check this out! Thanks!

@fadeevab fadeevab changed the title chore: add advanced command description and examples to goup Enhance README/lib.rs with advanced command description examples Feb 17, 2026
@fadeevab
Copy link
Contributor Author

fadeevab commented Feb 19, 2026

@benbrittain @erickt Thank you for your review in advance!

P.S.: I've already improved the README 6 years ago - PR #16 😄

Copy link
Collaborator

@erickt erickt left a comment

Choose a reason for hiding this comment

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

Otherwise looks good, thanks!

README.md Outdated
goup --height 5 --pilot-nickname Wes jump
```

## Note
Copy link
Collaborator

Choose a reason for hiding this comment

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

Could you leave this section on the bottom?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done, I moved it to the end of README!

Could you also check my other PR 🥹 #216 ... It enables flexible placing of top-level arguments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants