Skip to content

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

Closed
wants to merge 1 commit into from

Conversation

finchmeister
Copy link

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'.

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'.
@xabbuh
Copy link
Member

xabbuh commented Mar 1, 2017

👍

Status: Reviewed

Copy link
Contributor

@HeahDude HeahDude left a 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...')
Copy link
Contributor

Choose a reason for hiding this comment

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

"allows to create"?

Copy link
Author

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 👍

Copy link
Contributor

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".

Copy link
Author

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. :)

Copy link
Member

@javiereguiluz javiereguiluz left a comment

Choose a reason for hiding this comment

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

👍

@xabbuh
Copy link
Member

xabbuh commented Mar 1, 2017

I have no preference either. So I merged the PR as is. Thank you @finchmeister.

xabbuh added a commit that referenced this pull request Mar 1, 2017
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.
@xabbuh xabbuh closed this Mar 1, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants