Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork5.3k
Not use contraction#17765
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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Not use contraction#17765
Uh oh!
There was an error while loading.Please reload this page.
Conversation
b950ba4 to682562aComparejaviereguiluz commentedJan 18, 2023
I'd like to ask what's the motivation behind this. I thought that contractions like "it's" vs "it is" are so common that they are not considered vulgar or low-quality English. Maybe I'm missing something. |
weaverryan commentedJan 18, 2023
I'm a native English speaker (so my opinion only represents a minority of users), but I like contractions. I don't see the need for consistency. Sometimes I'd like to be casual, while other times I would really like to make a point, with a slightly different voice (<---- purposeful example in the previous statement of speaking inconsistently on purpose). Cheers! |
wouterj commentedJan 18, 2023 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
I like Ryan's point, as the last sentence did indeed feel the way it was meant to - even for a non-native like me (although, you could say I've become quite native concerning reading text written Ryan 😉). One of the things I like about writing docs for Symfony is the touch of casualness surrounded by the Symfony brand. While I've learned to not use contractions when writing academic papers, I think we should not strive to become too close to an academic paper. |
OskarStark commentedJan 18, 2023
Well explained 👍🏻 Let's close then |
alamirault commentedJan 18, 2023 • edited
Loading Uh oh!
There was an error while loading.Please reload this page.
edited
Uh oh!
There was an error while loading.Please reload this page.
It's clear ! Thanks for sharing your point of views |
…n standards (alexandre-daubois)This PR was merged into the 5.4 branch.Discussion----------[Standards] Freeze contractions decision in documentation standardsAs a decision has been made in#17765, I think this could be a good idea to freeze this in the documentation standards, in case someone is wondering again in the future.Commits-------1888db4 [Standards] Freeze contractions decision in documentation standards
Fix#17743
TODO