-
Notifications
You must be signed in to change notification settings - Fork 3k
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
Make pip <cmd> --help shorter #5399
Comments
And what is the alternative to hiding global options? |
Not hiding them? I don't think there's consensus that "being short enough to fit on one screen" is an important criterion for the help. I'd prefer "documents all available options" as the priority personally. Screens are varying sizes, and have scrollbars in typical environments, so while long help texts are maybe less convenient, I don't personally think that they are a major problem. |
@pfmoore what is the keyboard shortcut that you use to scrollback you typical environment? Because I have to use mouse and getting my hands off keyboard is annoying. |
I use the mouse, and don't find that annoying. I'm not saying it isn't annoying for you, just that it's not been demonstrated that it's annoying for a sufficient number of users to justify the change. That's what I meant by "consensus". |
If you'll run |
I don't need any help, I'm fine with the current behaviour. But if the behaviour was changed, then no, that wouldn't help as I'd have to look in 2 places for the information I want. Nevertheless, it's all subjective, so there's not much point in you trying to persuade me. Rather, what's needed is evidence that this would benefit a lot of other people, enough to overcome the normal "status quo wins" position. |
How do you want to collect the evidence? The only way I can think is to enable A/B testing and measure the time that passes between block of help commands and the next non-help command issued for both variants. |
Another thing here is pipenv style -- putting the commands at the end.
|
I like that. But from the recent developments the best is the help for
|
But we started to discuss a different topic. The issue is about help for a single command, not for initial list. |
In a survey response from a user, where they were asked what would make pip easier for them to use, the user said:
This response led to @ei8fdb and I spending over an hour working through |
From a user's perspective the current system (
|
pip list --help on pip 10.0.1
Previously proposed solution: not showing global options in --help for commands. (cf: #4433 and #3319)
I personally don't think this is an issue; but hey, this is up for discussion.
The text was updated successfully, but these errors were encountered: