Not use contraction #17765
Not use contraction #17765
Conversation
alamirault
force-pushed
the
no-contraction
branch
2 times, most recently
from
b950ba4 to
682562a
Compare
OskarStark
added
the
Waiting team decision
|
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. |
|
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! |
|
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. |
|
Well explained 👍🏻 Let's close then |
|
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 standards As 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