openstack
/
project-team-guide
Code Issues Proposed changes

Emphasize value of mailing lists 

Add a paragraph explaining why the mailing lists are the single
best resource we have for communication.

Change-Id: Ia887c11381ee8aabbce11c22938610aed8be3557
Story: 2001710
Task: 22658
This commit is contained in:
Chris Dent 2018-07-06 16:29:48 +01:00
parent c287dd8bf1
commit 7caa989af2
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/source/open-community.rst
View File

@ -61,6 +61,15 @@ cross-project communication. If an idea needs to span projects, the mailing
lists is a great place for this to happen. And finally, mailing lists are used
to interact with non-developer community members of OpenStack.
Because mailing lists are a form of asynchronous communication, they are the
best resource the community has for sharing information with, and getting ideas
from, the entire community. People who participate at different times of the
day or less regularly have a greater opportunity to engage. People who read or
write English with different levels of proficiency can be on a more (but not
perfectly) level playing field with email than they might be with synchronous
forms of text-based communication, such as IRC. When in doubt, prefer using a
mailing list to other options.
When using the mailing list for team communication, it's best to tag the
subject with the name of the project surrounded by brackets. For example,
to communicate something to the mailing list about Nova, you would add this