Skip to content

Commit 8386820

Browse files
committed
gh-1447: Add multicultural communication guidelines
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.
1 parent caeafb2 commit 8386820

File tree

2 files changed

+33
-1
lines changed

2 files changed

+33
-1
lines changed

developer-workflow/communication-channels.rst

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,37 @@ in return.
2222
.. _Diversity Statement: https://www.python.org/psf/diversity/
2323

2424

25+
.. _multicultural-communication:
26+
27+
Communicating across cultures and languages
28+
===========================================
29+
30+
Not every contributor writes English as a first language, and phrasing that
31+
feels neutral in one culture can read as blunt or rude in another.
32+
33+
**Assume good faith.** If a message feels abrupt, it's probably a language
34+
barrier or a different communication style rather than rudeness. If you're
35+
unsure what someone meant, ask: "I want to make sure I understand: are you
36+
saying X?"
37+
38+
**Use translation tools freely.** If English isn't your first language,
39+
translation software or AI tools can help you check that your message has the
40+
tone you intend. Getting the phrasing wrong can make a reasonable point sound
41+
more aggressive than it is.
42+
43+
**Watch out for rhetorical questions.** They read as hostile in text even when
44+
that's not the intent at all:
45+
46+
* Instead of "Why do you think it is wrong?!", try "That doesn't sound right
47+
to me. Here's why: …"
48+
* Instead of "Did you even read the docs?", try "The relevant documentation
49+
is at …"
50+
51+
**Be patient with newcomers.** If someone doesn't know how things work here,
52+
point them to the right docs or give them the context they need. Criticism
53+
without guidance isn't helpful.
54+
55+
2556
.. _mailinglists:
2657

2758
Mailing lists

triage/issue-tracker.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,8 @@ Disagreement with a resolution on the issue tracker
124124

125125
As humans, we will have differences of opinions from time to time. First and
126126
foremost, please be respectful that care, thought, and volunteer time went into
127-
the resolution.
127+
the resolution. Keep in mind that contributors come from many different cultural
128+
and linguistic backgrounds; see :ref:`multicultural-communication`.
128129

129130
With this in mind, take some time to consider any comments made in association
130131
with the resolution of the issue. On reflection, the resolution steps may seem

0 commit comments

Comments
 (0)