[Contributing] Avoid the use of controversial language #9529
Conversation
|
@codedmonkey thanks for this contribution! I'm pinging some people that frequently engage in discussions about diversity so they can give their opinion about this: @egircys, @lsmith77, @ElectricMaxxx, @sstok. Of course the entire community is also invited to discuss about this, no matter if they are in favor or against this change. The only condition is to not discuss about politics. We never discuss about politics in Symfony code and doc repos. Thanks! |
|
look fine to me. |
| While not "formally" required, it's better to use gender-neutral pronouns. | ||
| Unless someone "indicated" their pronouns, use "they", "them" instead of | ||
| "he", "she", "his", "hers", "his/hers", "he/she", etc. | ||
| In an effort to be inclusive to a wide group of developers, it's recommended to |
There was a problem hiding this comment.
Would it be better to use people instead of developers?
| words like "folks", "team", "everyone" in place of "guys". | ||
| Try to avoid using wording that may be considered excluding, needlessly gendered | ||
| (e.g. words that have a male or female base), racially motivated or singles out | ||
| a particular group in society. For example, we recommend to use words like |
There was a problem hiding this comment.
Maybe keep the same form, like in the previous block, it's recommended instead of we recommend?
There was a problem hiding this comment.
Fully agree. In the Symfony Docs we never use "we". It was a decision taken a few years ago, so we prefer to keep it. Thanks!
javiereguiluz
added
the
diversity & inclusion
|
Great addition 👍 |
…ewpoint for everyone
javiereguiluz
force-pushed
the
fix_controversial_language
branch
from
ae843d9 to
60aec5f
Compare
|
Thanks ... and congrats on your first Symfony Docs contribution! |
…odedmonkey) This PR was submitted for the 3.4 branch but it was merged into the 2.7 branch instead (closes #9529). Discussion ---------- [Contributing] Avoid the use of controversial language This PR removes the usage of any controversial and politically charged wording from the guidelines for review comments. This PR is not meant to diminish any problem anybody is having, rather to enforce the idea that addressing any person in any undesirable way is a no-go. Commits ------- 60aec5f Rewrite the gender-neutral pronoun section to reflect an inclusive viewpoint for everyone
|
Thanks for the positive responses :) Great additions to the docs! |
This PR removes the usage of any controversial and politically charged wording from the guidelines for review comments. This PR is not meant to diminish any problem anybody is having, rather to enforce the idea that addressing any person in any undesirable way is a no-go.