[CLI] Better handling of aliases in documentation (#3840)
* Improve alias handling in CLI documentation
- Add _normalize_command_aliases() to transform pipe-separated aliases
into proper documentation format
- Command list: Show 'cmd: (alias: alias) Description' instead of 'cmd | alias: Description'
- Section headers: Use only main command name, append alias to description
- Usage examples: Show only main command name
Addresses feedback from PR #3836
Co-authored-by: Lucain <Wauplin@users.noreply.github.com>
* Update alias format to [alias: ...] at end of description
- Update _cli_utils.py format_commands() to show aliases at end of help text
- Change format from '(alias: ...)' to '[alias: ...]'
- Update generate_cli_reference.py to match the same format
Now both 'hf --help' locally and the generated docs use consistent format:
list List buckets or files in a bucket. [alias: ls]
Co-authored-by: Lucain <Wauplin@users.noreply.github.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Lucain <Wauplin@users.noreply.github.com>