-
-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Made 'create-user' command consistent. #7551
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
Conversation
There is a very minor inconsistency between the naming of the 'create users' command at the beginning of the document and the 'create user' command for the rest of the article. It starts with the plural, then changes to singular. A very minor thing, but when you're following the documentation precisely, this inconsistency raises unnecessary questions. Updated all references to 'create-user'.
👍 Status: Reviewed |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
|
||
// the full command description shown when running the command with | ||
// the "--help" option | ||
->setHelp('This command allows you to create users...') | ||
->setHelp('This command allows you to create a user...') |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"allows to create"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would say 'This command allows you to create a user...' is perfectly valid 👍
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not saying it isn't :), I would just avoid the "you".
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could I persuade you by comparing the two side by side?
'This command allows you to create a user...'
'This command allows to create a user...'
For me, the first one is nicer to read. :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
I have no preference either. So I merged the PR as is. Thank you @finchmeister. |
This PR was submitted for the 3.2 branch but it was merged into the 2.7 branch instead (closes #7551). Discussion ---------- Made 'create-user' command consistent. There is a very minor inconsistency between the naming of the 'create users' command at the beginning of the document and the 'create user' command for the rest of the article. It starts with the plural, then changes to singular. A very minor thing, but when you're following the documentation precisely, this inconsistency raises unnecessary questions. Updated all references to 'create-user'. Commits ------- d04bcc4 Made 'create-user' command consistent.
There is a very minor inconsistency between the naming of the 'create users' command at the beginning of the document and the 'create user' command for the rest of the article. It starts with the plural, then changes to singular. A very minor thing, but when you're following the documentation precisely, this inconsistency raises unnecessary questions. Updated all references to 'create-user'.