Skip to content

Conversation

MozirDmitriy
Copy link
Contributor

Motivation

The current CLI commands (forge create, forge verify-contract, cast send, cast call) lack detailed help messages, usage examples, and clear argument descriptions. This can make it difficult for both new and experienced users to understand the full capabilities and correct usage of these commands. Improving the UX of the CLI will make Foundry more approachable and user-friendly.

Solution

  • Added or improved about and long_about descriptions for the most important CLI commands.
  • Enhanced help messages for all key arguments and flags, making them more descriptive and actionable.
  • Added value_name for all arguments that accept values, improving clarity in help output.
  • Included real-world usage examples in the long_about or as comments, based on actual CLI syntax and documentation.
  • No changes to logic or behavior—only user-facing descriptions and documentation were improved.

PR Checklist

[ ] Added Tests (N/A: documentation/help only)
[x] Added Documentation (improved CLI help and usage)
[ ] Breaking changes (No breaking changes)

Note:

This PR does not introduce any breaking changes or modify command logic. All changes are focused on improving the CLI user experience through better documentation and help output.

Copy link
Member

@DaniPopes DaniPopes left a comment

Choose a reason for hiding this comment

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

help is automatically derived from the doccomment, please remove

@MozirDmitriy
Copy link
Contributor Author

help is automatically derived from the doccomment, please remove

Yes

@DaniPopes
Copy link
Member

Thanks but we decided not to go with this

@DaniPopes DaniPopes closed this Aug 21, 2025
@github-project-automation github-project-automation bot moved this to Done in Foundry Aug 21, 2025
@MozirDmitriy MozirDmitriy deleted the Cli branch August 27, 2025 14:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

2 participants