You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by ke...@apache.org on 2018/05/04 19:41:33 UTC

[beam-site] 01/04: Add "Become a Committer" with PMC guidelines

This is an automated email from the ASF dual-hosted git repository.

kenn pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/beam-site.git

commit 2bcd10373aa15f5d3db9ea611bcec4049a5793af
Author: Kenneth Knowles <kl...@google.com>
AuthorDate: Fri May 4 06:53:35 2018 -0700

    Add "Become a Committer" with PMC guidelines
    
     - PMC has reached consensus on these committer guidelines
     - Rearranged the "Team" bits since there were redundancies
---
 src/{_beam_team/team.md => _data/team.yml} | 177 ++++++++++++++---------------
 src/_includes/section-menu/contribute.html |  11 +-
 src/contribute/become-a-committer.md       |  89 +++++++++++++++
 src/contribute/team.md                     |  13 +--
 4 files changed, 186 insertions(+), 104 deletions(-)

diff --git a/src/_beam_team/team.md b/src/_data/team.yml
similarity index 90%
rename from src/_beam_team/team.md
rename to src/_data/team.yml
index 4a475dd..2b1f7c2 100644
--- a/src/_beam_team/team.md
+++ b/src/_data/team.yml
@@ -1,43 +1,114 @@
 ---
-group: "Beam Committers"
-description: "The following is a list of developers with commit privileges that have directly contributed to the project in one way or another."
-members:
+
+groups:
+- name: "Project Management Committee"
+  members:
   - name: Tyler Akidau
     apache_id: takidau
     email: takidau [at] apache [dot] org
     organization: Google
-    roles: committer, PMC
     time_zone: "-8"
   - name: Ahmet Altay
     apache_id: altay
     email: altay [at] apache [dot] org
     organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
-  - name: Jesse Anderson
-    apache_id: jesseanderson
-    email: jesseanderson [at] apache [dot] org
-    organization: Smoking Hand
-    roles: committer
     time_zone: "-8"
   - name: Davor Bonaci
     apache_id: davor
     email: davor [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC Chair
+    organization:
     time_zone: "-8"
   - name: Robert Bradshaw
     apache_id: robertwb
     email: robertwb [at] apache [dot] org
     organization: Google
-    roles: committer, PMC
     time_zone: "-8"
   - name: Ben Chambers
     apache_id: bchambers
     email: bchambers [at] apache [dot] org
+    organization:
+    time_zone: "-8"
+  - name: Luke Cwik
+    apache_id: lcwik
+    email: lcwik [at] apache [dot] org
+    organization: Google
+    time_zone: "-8"
+  - name: Stephan Ewen
+    apache_id: sewen
+    email: sewen [at] apache [dot] org
+    organization: data Artisans
+    time_zone: "+1"
+  - name: Dan Halperin
+    apache_id: dhalperi
+    email: dhalperi [at] apache [dot] org
+    organization: Google
+    time_zone: "-8"
+  - name: Kenneth Knowles
+    apache_id: kenn
+    email: kenn [at] apache [dot] org
+    organization: Google
+    time_zone: "-8"
+  - name: Aljoscha Krettek
+    apache_id: aljoscha
+    email: aljoscha [at] apache [dot] org
+    organization: data Artisans
+    time_zone: "+1"
+  - name: Reuven Lax
+    apache_id: reuvenlax
+    email: reuvenlax [at] apache [dot] org
+    organization: Google
+    time_zone: "-8"
+  - name: Ismaël Mejía
+    apache_id: iemejia
+    email: iemejia [at] apache [dot] org
+    organization: Talend
+    roles: committer, PMC
+    time_zone: "+1"
+  - name: Maximilian Michels
+    apache_id: mxm
+    email: mxm [at] apache [dot] org
+    organization: Crate.io
+    roles: committer, PMC
+    time_zone: "+1"
+  - name: Jean-Baptiste Onofré
+    apache_id: jbonofre
+    email: jbonofre [at] apache [dot] org
+    organization: Talend
+    roles: committer, PMC
+    time_zone: "+1"
+  - name: Frances Perry
+    apache_id: frances
+    email: frances [at] apache [dot] org
     organization: Google
     roles: committer, PMC
     time_zone: "-8"
+  - name: Amit Sela
+    apache_id: amitsela
+    email: amitsela [at] apache [dot] org
+    organization: PayPal
+    roles: committer, PMC
+    time_zone: "+2"
+  - name: Josh Wills
+    apache_id: jwills
+    email: jwills [at] apache [dot] org
+    organization: Slack
+    roles: committer, PMC
+    time_zone: "-8"
+  - name: Aviem Zur
+    apache_id: aviemzur
+    email: aviemzur [at] apache [dot] org
+    organization: PayPal
+    roles: committer, PMC
+    time_zone: "+2"
+
+- name: "Committers"
+  members:
+  - name: Jesse Anderson
+    apache_id: jesseanderson
+    email: jesseanderson [at] apache [dot] org
+    organization: Smoking Hand
+    roles: committer
+    time_zone: "-8"
   - name: Etienne Chauchot
     apache_id: echauchot
     email: echauchot [at] apache [dot] org
@@ -50,36 +121,18 @@ members:
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Luke Cwik
-    apache_id: lcwik
-    email: lcwik [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
   - name: Pablo Estrada
     apache_id: pabloem
     email: pabloem [at] apache [dot] org
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Stephan Ewen
-    apache_id: sewen
-    email: sewen [at] apache [dot] org
-    organization: data Artisans
-    roles: committer, PMC
-    time_zone: "+1"
   - name: Thomas Groh
     apache_id: tgroh
     email: tgroh [at] apache [dot] org
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Dan Halperin
-    apache_id: dhalperi
-    email: dhalperi [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
   - name: Pei He
     apache_id: pei
     email: pei [at] apache [dot] org
@@ -98,30 +151,12 @@ members:
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Kenneth Knowles
-    apache_id: kenn
-    email: kenn [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
-  - name: Aljoscha Krettek
-    apache_id: aljoscha
-    email: aljoscha [at] apache [dot] org
-    organization: data Artisans
-    roles: committer, PMC
-    time_zone: "+1"
   - name: Jason Kuster
     apache_id: jaku
     email: jaku [at] apache [dot] org
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Reuven Lax
-    apache_id: reuvenlax
-    email: reuvenlax [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
   - name: Jingsong Lee
     apache_id: lzljs3620320
     email: lzljs3620320 [at] apache [dot] org
@@ -134,54 +169,18 @@ members:
     organization: PayPal
     roles: committer
     time_zone: "+2"
-  - name: Ismaël Mejía
-    apache_id: iemejia
-    email: iemejia [at] apache [dot] org
-    organization: Talend
-    roles: committer, PMC
-    time_zone: "+1"
-  - name: Maximilian Michels
-    apache_id: mxm
-    email: mxm [at] apache [dot] org
-    organization: Crate.io
-    roles: committer, PMC
-    time_zone: "+1"
-  - name: Jean-Baptiste Onofré
-    apache_id: jbonofre
-    email: jbonofre [at] apache [dot] org
-    organization: Talend
-    roles: committer, PMC
-    time_zone: "+1"
   - name: Melissa Pashniak
     apache_id: melap
     email: melap [at] apache [dot] org
     organization: Google
     roles: committer
     time_zone: "-8"
-  - name: Frances Perry
-    apache_id: frances
-    email: frances [at] apache [dot] org
-    organization: Google
-    roles: committer, PMC
-    time_zone: "-8"
-  - name: Amit Sela
-    apache_id: amitsela
-    email: amitsela [at] apache [dot] org
-    organization: PayPal
-    roles: committer, PMC
-    time_zone: "+2"
   - name: Thomas Weise
     apache_id: thw
     email: thw [at] apache [dot] org
     organization: Atrato
     roles: committer
     time_zone: "-8"
-  - name: Josh Wills
-    apache_id: jwills
-    email: jwills [at] apache [dot] org
-    organization: Slack
-    roles: committer, PMC
-    time_zone: "-8"
   - name: Mingmin Xu
     apache_id: mingmxu
     email: mingmxu [at] apache [dot] org
@@ -194,12 +193,6 @@ members:
     organization: Vipshop
     roles: committer
     time_zone: "+8"
-  - name: Aviem Zur
-    apache_id: aviemzur
-    email: aviemzur [at] apache [dot] org
-    organization: PayPal
-    roles: committer, PMC
-    time_zone: "+2"
   - name: James Xu
     apache_id: xumingming
     email: xumingming [at] apache [dot] org
diff --git a/src/_includes/section-menu/contribute.html b/src/_includes/section-menu/contribute.html
index 65406df..69bfcce 100644
--- a/src/_includes/section-menu/contribute.html
+++ b/src/_includes/section-menu/contribute.html
@@ -5,12 +5,20 @@
 
   <ul class="section-nav-list">
     <li><a href="{{ site.baseurl }}/contribute/contribution-guide/">Contribution guide</a></li>
-    <li><a href="{{ site.baseurl }}/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="{{ site.baseurl }}/contribute/website-contributions/">Website contributions</a></li>
     <li><a href="{{ site.baseurl }}/contribute/feature-branches/">Feature branches</a></li>
   </ul>
 </li>
 <li>
+  <span class="section-nav-list-title">Committers</span>
+
+  <ul class="section-nav-list">
+    <li><a href="{{ site.baseurl }}/contribute/become-a-committer/">Become a committer</a></li>
+    <li><a href="{{ site.baseurl }}/contribute/committer-guide/">Committer guide</a></li>
+    <li><a href="{{ site.baseurl }}/contribute/team/">Team</a></li>
+  </ul>
+</li>
+<li>
   <span class="section-nav-list-title">IDE tips</span>
 
   <ul class="section-nav-list">
@@ -48,4 +56,3 @@
   </ul>
 </li>
 <li><a href="{{ site.baseurl }}/contribute/maturity-model/">Maturity Model</a></li>
-<li><a href="{{ site.baseurl }}/contribute/team/">Team</a></li>
diff --git a/src/contribute/become-a-committer.md b/src/contribute/become-a-committer.md
new file mode 100644
index 0000000..0d48917
--- /dev/null
+++ b/src/contribute/become-a-committer.md
@@ -0,0 +1,89 @@
+---
+layout: section
+title: "Become A Committer"
+permalink: /contribute/become-a-committer/
+section_menu: section-menu/contribute.html
+---
+
+# Become a Committer
+
+An Apache Beam
+[committer](https://www.apache.org/foundation/how-it-works.html#committers) has
+write access to the repository for merging pull requests, but you don't have
+to be a code contributor to become a committer. Becoming a committer means that
+you have the project's trust. Read the [ASF
+documentation](https://www.apache.org/dev/committers.html#committer-responsibilities)
+for more about being a committer in the Apache Software Foundation.
+
+The [PMC](https://www.apache.org/foundation/how-it-works.html#pmc-members)
+makes someone a committer via nomination, discussion, and then majority vote.
+We use data from as many sources as possible to inform our reasoning. Here are
+some examples: 
+
+ - [dev@ archives](https://lists.apache.org/list.html?dev@beam.apache.org) and [statistics](https://lists.apache.org/trends.html?dev@beam.apache.org)
+ - [user@ archives](https://lists.apache.org/list.html?user@beam.apache.org) and [statistics](https://lists.apache.org/trends.html?user@beam.apache.org)
+ - [`apache-beam` StackOverflow tag](https://stackoverflow.com/questions/tagged/apache-beam)
+ - Git metrics for [Beam](https://github.com/apache/beam/graphs/contributors)
+   and the [Beam site](https://github.com/apache/beam-site/graphs/contributors)
+ - Code reviews given and received on
+   [Beam](https://github.com/apache/beam/pulls) and the [Beam
+   site](https://github.com/apache/beam-site/pulls)
+ - Clear areas of ownership (a runner, a DSL, IO connector, documentation,
+   etc.)
+ - Public events
+ - Firsthand PMC testimonials
+
+The PMC has assembled the following set of guidelines for becoming a committer.
+
+## An Apache Beam committer...
+
+### Takes many forms
+
+There are many actions other than coding that build the trust we place in a
+committer - code review, design discussion, user support, community outreach, improving
+infrastructure, documentation, project management, etc.
+
+### Knows, upholds, and reinforces the Apache Software Foundation code of conduct
+
+See the [ASF
+documentation](https://www.apache.org/foundation/policies/conduct.html). In
+particular, they manifestly strive to:
+
+ - Be open
+ - Be empathetic
+ - Be welcoming
+ - Be friendly
+ - Be patient
+ - Be collaborative
+ - Be inquisitive
+ - Be careful in the words that they choose
+
+### Knows, upholds, and reinforces the responsibilities of an Apache Software Foundation committer
+
+See the [ASF documentation](https://www.apache.org/dev/committers.html#committer-responsibilities).
+
+ - They help create a product that will outlive the interest of any particular
+   volunteer (including themselves)
+ - They grow and maintain the health of the Apache community
+ - They help out with surrounding work, such as the website & documentation
+ - They help users
+ - They can be trusted to decide when code is ready for release, or when to ask
+   someone else to make the judgment
+ - They can be trusted to decide when to merge code (if a code contributor) or
+   when to ask someone else to make the judgment
+
+### Knows, upholds, and reinforces the Beam community’s practices
+
+ - They have a proven commitment to the project
+ - They share their intentions with the community
+ - They accept and integrate community feedback in their on plans, designs,
+   code, etc.
+ - They earnestly try to make Beam better with their contributions
+ - In particular, if a code contributor:
+   - They earnestly try to make Beam better with their own code
+   - They earnestly try to make Beam better with code review
+   - They accept and integrate feedback on their code
+   - They know, follow, and enforce Beam’s practices while
+     reviewing/merging code - style, documentation, testing, backward
+     compatibility, etc.
+
diff --git a/src/contribute/team.md b/src/contribute/team.md
index 9442d88..bc6043c 100644
--- a/src/contribute/team.md
+++ b/src/contribute/team.md
@@ -10,13 +10,8 @@ redirect_from:
 
 # Apache Beam Team
 
-A successful project requires many people to play many roles. Some members write code or documentation, while others are valuable as testers, submitting patches and suggestions.
-
-The team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base. Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded. Get involved today. All contributions to the project are greatly appreciated.
-
-{% for team in site.beam_team %}
-  <h2>{{ team.group }}</h2>
-  <p>{{ team.description }}</p>
+{% for group in site.data.team.groups %}
+  <h2>{{ group.name }}</h2>
   <table class="table table-hover">
     <thead>
       <tr>
@@ -24,18 +19,16 @@ The team is comprised of Members and Contributors. Members have direct access to
         <th>Apache ID</th>
         <th>Email</th>
         <th>Organization</th>
-        <th>Roles</th>
         <th>Time Zone</th>
       </tr>
     </thead>
     <tbody>
-      {% for member in team.members %}
+      {% for member in group.members %}
         <tr>
           <th scope="row">{{ member.name }}</th>
           <td scope="row">{{ member.apache_id }}</td>
           <td scope="row">{{ member.email }}</td>
           <td scope="row">{{ member.organization }}</td>
-          <td scope="row">{{ member.roles }}</td>
           <td scope="row">{{ member.time_zone }}</td>
         </tr>
       {% endfor %}

-- 
To stop receiving notification emails like this one, please contact
kenn@apache.org.