<div dir="ltr">Hi all, <div>I liked Matthew's examples of how to nicely suggest improvements to commit messages, review comments, and so on. Something about a monocle-wearing English gentleman's polite speech leads me to believe that our community members would appreciate some guidelines and training, but I don't know how others feel about this under a "Documentation" umbrella. Perhaps it belongs with the CodeReviewGuidelines? More input and discussion -- with the idea being, how can we help improve communication around the code and docs?</div>

<div>Thanks,</div><div>Anne</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Dec 12, 2013 at 2:38 AM, Matthew Mosesohn <span dir="ltr"><<a href="mailto:mmosesohn@mirantis.com" target="_blank">mmosesohn@mirantis.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Stackers,<br>
<br>
After some discussion about the Code Review Guidelines<br>
(<a href="https://wiki.openstack.org/wiki/CodeReviewGuidelines" target="_blank">https://wiki.openstack.org/wiki/CodeReviewGuidelines</a>), it's come to<br>
my attention that there is plenty of advice that could be shared with<br>
the rest of the community about how to participate effectively, yet<br>
respectfully, in various forms of communication. The scope of<br>
communication I want to cover includes messages on IRC, mailing lists,<br>
code review, and commit messages. It's quite obvious for most of you<br>
that kindness and respect for your fellow developer helps reduce<br>
friction that may arise when trying to contribute to OpenStack or get<br>
help.<br>
<br>
The intended audience for this discussion is not our core contributors<br>
who speak English as a native language, but instead for those who are<br>
interested in participating, but need to improve their writing skills.<br>
Frankly speaking, in some languages, direct speech can seem harsh when<br>
written literally in English.<br>
<br>
After speaking with Anne Gentle, she suggested creating a<br>
communcations guideline page as a child page under<br>
<a href="https://wiki.openstack.org/wiki/Documentation/Conventions" target="_blank">https://wiki.openstack.org/wiki/Documentation/Conventions</a> with a<br>
similar format, showing correct and incorrect models of communication.<br>
<br>
The intent of starting this thread is to field some suggestions or<br>
possibly point out some examples of items that should be included in<br>
this document. I'm not asking for serious investment from the Docs<br>
team, but if you have ideas, please feel free to share them. Thank you<br>
for your time.<br>
<br>
Best Regards,<br>
Matthew Mosesohn<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br></div>