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

ui: '-j' option now mentions docs #4382

Merged
merged 2 commits into from
Aug 15, 2020
Merged

Conversation

nik123
Copy link
Contributor

@nik123 nik123 commented Aug 12, 2020

Fixes #1310

I don't think that documentation should be updated.

Comment on lines 100 to 101
help="Number of jobs to run simultaneously. "
"Refer to docs to get default value.",
Copy link
Member

@efiop efiop Aug 14, 2020

Choose a reason for hiding this comment

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

Maybe let's just copypaste from docs? E.g. from https://dvc.org/doc/command-reference/push

The default value is 4 * cpu_count(). For SSH remotes, the default is 4. Using more jobs may improve the overall transfer speed.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I've noticed that most help messages are short (2 sentences max) so I decided to use "refer to docs...". However, I have no strong opinion in that regard. If it's fine to have long messages I can copy text from cmd ref.

Copy link
Member

Choose a reason for hiding this comment

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

Yes, there is no limit for the help messages. We could totally copypaste those two sentences :) Thank you! πŸ™

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I've updated message

@nik123 nik123 requested a review from efiop August 15, 2020 18:38
Copy link
Member

@efiop efiop left a comment

Choose a reason for hiding this comment

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

Thank you so much @nik123 ! πŸ™

@efiop efiop merged commit 4439294 into iterative:master Aug 15, 2020
@nik123 nik123 deleted the JHelpDefaultValue branch August 15, 2020 18:59
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.

Improve -j help messages
3 participants