Add multicultural communication guidelines#1788
Open
johnslavik wants to merge 1 commit intopython:mainfrom
Open
Add multicultural communication guidelines#1788johnslavik wants to merge 1 commit intopython:mainfrom
johnslavik wants to merge 1 commit intopython:mainfrom
Conversation
Add a new section covering good-faith assumptions, use of translation and language tools, collaborative phrasing, and patience/mentoring for contributors communicating across cultural and linguistic backgrounds.
johnslavik
requested review from
Mariatta,
StanFromIreland,
hugovk and
willingc
Documentation build overview
83 files changed ·
|
Member
Author
|
(I've considered separate headings but I chose bold leads because they aren't separate topics and this keeps the section skimmable without inflating the page's TOC or heading hierarchy.) |
willingc
reviewed
Apr 20, 2026
Collaborator
willingc
left a comment
willingc
left a comment
There was a problem hiding this comment.
Hi @johnslavik. Thanks for taking the time to write this up which I know is not an easy task. Overall, I like it. I'm suggest reframing "assume good faith" into two separate recommendations that are similar in spirit and provide more clarity.
Comment on lines
+38
to
+41
| **Use translation tools freely.** If English isn't your first language, | ||
| translation software or AI tools can help you check that your message has the | ||
| tone you intend. Getting the phrasing wrong can make a reasonable point sound | ||
| more aggressive than it is. |
Collaborator
There was a problem hiding this comment.
Suggested change
| **Use translation tools freely.** If English isn't your first language, | |
| translation software or AI tools can help you check that your message has the | |
| tone you intend. Getting the phrasing wrong can make a reasonable point sound | |
| more aggressive than it is. | |
| **Use translation tools freely.** If English isn't your first language, | |
| translation software or AI tools may help you check that your message has the | |
| tone you intend. Getting the phrasing wrong can make a reasonable point sound | |
| more aggressive than it is. |
Comment on lines
+31
to
+36
| feels neutral in one culture can read as blunt or rude in another. | ||
|
|
||
| **Assume good faith.** If a message feels abrupt, it's probably a language | ||
| barrier or a different communication style rather than rudeness. If you're | ||
| unsure what someone meant, ask: "I want to make sure I understand: are you | ||
| saying X?" |
Collaborator
There was a problem hiding this comment.
Suggested change
| feels neutral in one culture can read as blunt or rude in another. | |
| **Assume good faith.** If a message feels abrupt, it's probably a language | |
| barrier or a different communication style rather than rudeness. If you're | |
| unsure what someone meant, ask: "I want to make sure I understand: are you | |
| saying X?" | |
| feels neutral in one culture can read as blunt or rude in another. | |
| **Practice active listening.** Try to focus on understanding the message before reacting. | |
| **Confirm Understanding.** Ask open-ended questions and paraphrase to avoid misunderstandings. If you're | |
| unsure what someone meant, ask: "I want to make sure I understand: are you | |
| saying X?" |
I would like us to remove "Assume good faith." It is often used as an excuse or escape hatch for bullies to insincerely disregard other people.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a new section covering good-faith assumptions, use of translation and language tools, collaborative phrasing, and patience/mentoring for contributors communicating across cultural and linguistic backgrounds.
Closes #1447.