Open Stack

Hi all,
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?
Thanks,
Anne


On Thu, Dec 12, 2013 at 2:38 AM, Matthew Mosesohn <mmosesohn at mirantis.com>wrote:

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