[GitHub] [airflow] nuclearpinguin commented on a change in pull request #7204: [AIRFLOW-XXXX] - add communication chapter to contributing

[GitBox <gi...@apache.org>]

nuclearpinguin commented on a change in pull request #7204: [AIRFLOW-XXXX] - add communication chapter to contributing
URL: https://github.com/apache/airflow/pull/7204#discussion_r368311322
 
 

 ##########
 File path: CONTRIBUTING.rst
 ##########
 @@ -664,6 +664,63 @@ Later on
    above depending if you have more commits that cause conflicts in your PR (rebasing applies each
    commit from your PR one-by-one).
 
+How to communicate
+==================
+
+Apache Airflow is a Community within Apache Software Foundation. As the motto of
+the Apache Software Foundation states "Community over Code" - people in the
+community are far more important than the code they create.
+
+This means that communication is very important, and this chapter is all about it.
+
+We have various channel of communication - starting from the official devlist, comments
+in the Pull Requests, Slack, wiki.
+
+All those channels can be used for different purposes:
+
+* The devlist for official communication, discussing proposals, voting, general issues, asking community for
+  opinion etc.
+* Wiki for detailed discussions on big proposals (AIPs) and some helpful, shared resources.
+* PRs for discussing implementation details of this PR (not for architectural discussions)
+* Slack for ad-hoc questions, troubleshooting, occassional discussions, group talks (including SIG - special
+interest groups), notifications, random queries, newbie questions etc.
+
+
+It is important to remember that all contributors, committers and even PMC members are individuals
+that contribute a lot of their free time on top of their work time to Apache Airflow.
+They have families, personal life, sometimes they are swamped with work, sometimes they are on vacations
+sometimes they are simply tired and need a time off. They are in various timezones and their responsiveness
+will vary from time to time. As a community project we have no formal structure, we have no managers nor
+departments and most of the people are autonomous in their opinions and decisions, so sometimes even
+committers will have different opinions on the same subjects.
+
+Disagreements are expected, discussions might include strong opinions and contradicting statements.
+Sometimes you might get two committers asking you to do things differently. This all happened in the past
+and will continue to happen. As a community we have some mechanisms to facilitate discussion and come to
+a consensus, conclusions and sometime we end up voting certain decisions. It is important that those
+decisions are not treated as personal wins or looses - at the end it's the community that we care about
+and what's good for community, should be accepted even if you have different opinion. There is the nice
+motto that you should follow in case you disagree with community decision "Disagree but engage". Even
+if you do not agree with a community decision, you should follow it and embrace (but you are free to
+express your opinion that you don't agree with it).
+
+Here are a few rules that are important to keep in mind when you enter our community:
+
+ * Do not be afraid to ask questions
+ * We have deeply asynchronous communication - do not expect immediate answers, ping people if you are blocked
+ * We have #newbie-questions channel in slack as a safe place to ask questions
+ * You can ask one of the committers to be a mentor for you, they can guide within the community
+ * You can apply to more structured Apache Mentoring Programme
+ * It’s your responsibility as an author to take your PR from start-to-end including leading communication
+   in the PR
+ * It’s your responsibility as an author to ping committers to review your PR - be mildly annoying sometimes,
+   it’s OK to be slightly annoying with your change - it is also a sign for committers that you care
+ * We have high-bar set for the code requirements - be considerate to those requirements
+ * If in doubt - ask community for their opinions and sometimes voting at the devlist
 
 Review comment:
   ```suggestion
    * If in doubt - ask the community for their opinion or propose to vote at the devlist
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services