You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@beam.apache.org by GitBox <gi...@apache.org> on 2022/03/21 12:11:50 UTC
[GitHub] [beam] AydarZaynutdinov commented on a change in pull request #17136: Beam 13991 update contribute to beam page
AydarZaynutdinov commented on a change in pull request #17136:
URL: https://github.com/apache/beam/pull/17136#discussion_r831015637
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
Review comment:
```suggestion
Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
```
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Propose a feature</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a feature request</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Feature Proposal] <your idea>.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Improve documentation</td>
+ <td>
+ Click the edit icon in our documentation and it’ll take you to our <a href="https://github.com/apache/beam/">GitHub</a>, where you can automatically make the change you want and send a Pull Request.
Review comment:
```suggestion
Click the edit icon in our documentation and it’ll take you to our <a href="https://github.com/apache/beam/">GitHub</a>, where you can automatically make the change you want and send a Pull Request.
```
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Propose a feature</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a feature request</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Feature Proposal] <your idea>.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Improve documentation</td>
+ <td>
+ Click the edit icon in our documentation and it’ll take you to our <a href="https://github.com/apache/beam/">GitHub</a>, where you can automatically make the change you want and send a Pull Request.
+ </td>
+ </tr>
+ <tr>
+ <td>Improve the website</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Follow the website <a href="https://beam.apache.org/contribute/">Contribution Guide</a> to make changes yourself.</li>
+ <li>Check our <a href="https://issues.apache.org/jira/browse/BEAM-13229?jql=project%20%3D%20BEAM%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20website%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">Website Backlog</a> in Jira to find rooms for improvement areas, or propose one.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Write a blogpost</td>
+ <td>
+ Tell a story about your custom use cases or share your recommendations and best practices.
+ </td>
+ </tr>
+ <tr>
+ <td>Share your success story</td>
+ <td>
+ Visit our <a href="https://beam.apache.org/case-studies/">Case Studies</a> page and share your story or add your company’s logo.
+ </td>
+ </tr>
+ <tr>
+ <td>Produce a social media publication</td>
+ <td>
+ Share the use cases that Beam helps empower or the data processing performance you achieved. Spread the word about the upcoming Beam Summits and conferences.
+ </td>
+ </tr>
+ <tr>
+ <td>Organize an event</td>
+ <td>
+ Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> to share your idea about the Beam event you want to organize.
+ </td>
+ </tr>
+ <tr>
+ <td>Build a new feature like a new IO connector or PTransform</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Create and contribute a custom <a href="https://beam.apache.org/documentation/programming-guide/#pipeline-io">I/O connector</a> for a specific data storage system you want to connect to, if it is not on <a href="https://beam.apache.org/documentation/io/built-in/">the I/O list yet</a>.</li>
+ <li>Look at our project backlog to get some inspiration on what to build.</li>
+ <li>Follow our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Share a code sample or template</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Read our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ <li>Create your code sample or template. </li>
+ <li><a href="https://beam.apache.org/contribute/#make-your-change">Make a Pull Request</a> to add it to the Beam example folder.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Test a release candidate</td>
+ <td>
+ Anybody can <a href="https://beam.apache.org/contribute/release-guide/">propose a release</a> via the dev@beam.apache.org mailing list. Try Apache Beam releases in your projects, vote for release candidates, inform the community about the results and any issues found via <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>. Learn more about how to validate a Beam release <a href="https://beam.apache.org/blog/validate-beam-release/">here</a>.
+ </td>
+ </tr>
+ <tr>
+ <td>Other ideas?</td>
+ <td>
+ If you want to contribute in another way and you’re not sure how to get started, send a proposal to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>.
+ </td>
+ </tr>
+</table>
+
+
+## Become a Committer
+
+If you like contributing to Apache Beam, you are active in the Apache Beam mailing lists, Slack channel, or you attend/organize events, then you are a candidate to become a project committer.
+
+Committers are community members that have write access to the project’s repositories (i.e., they can modify the code, documentation, and website by themselves and also assist with code reviews and accept other contributions).
+
+Even though there is no strict protocol to become a committer, the most important thing we look for is that you display the traits of an Apache Beam committer and that you have been consistently contributing to the project and community.
+
+Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC team. So if you would like to become a committer, engage with the community and keep contributing to Apache Beam, you might also want to talk to other committers and ask for their advice and guidance. Feel free to email any committer directly and ask for their advice!
+
+## The Traits of an Apache Beam Committer
+
+{{< contributor/row_of_traits committer_traits >}}
+
+## Become a Project Management Committee (PMC) Member
+
+The PMC is the official managing body of the project as per the Apache Software Foundation governance model: “The Apache Way”. PMC members vote to set Apache Beam’s community and technical direction and are directly responsible for overseeing releases and the healthy development of the community.
+
+PMC members are also responsible for ensuring their project follows certain core requirements set by the board or other corporate officers of the ASF, like following Legal, Branding, and Infrastructure related requirements, along with ensuring their community operates within the [ASF Code of Conduct](https://www.apache.org/foundation/policies/conduct#code-of-conduct).
+
+Since the PMC members are responsible for establishing the Apache Beam vision and leading our community to work in harmony to achieve it, we look for committed individuals who can perform the responsibilities of the PMC, as well as lead our community to fulfill its vision. This is why we strive to build a diverse PMC that complements skills and expertise sharing the same sets of values.
+
+Ideally, we find candidates among active community members that have shown initiative to shape the direction of Beam and have shown willingness to learn the official processes, such as how to create or verify for releases, how to ensure trademark compliance for events, among others. We also expect PMC candidates to be level-headed, constructive, supportive, and willing to “disagree and commit” at times.
+
+A PMC member is also a committer, so if they are not initiated already, they will automatically become committers when joining the PMC. Therefore, the traits of Apache Beam committers also apply to PMC members.
+
+## Hear from the Community
+
+“Knowledge sharing and collaboration is something that comes naturally in the community. Together, we can work with the most complex problems and just solve them.
+”Matt Casters, Co-founder @ Apache Hop
Review comment:
```suggestion
“Knowledge sharing and collaboration is something that comes naturally in the community. Together, we can work with the most complex problems and just solve them.”
Matt Casters, Co-founder @ Apache Hop
```
`Matt Casters, Co-founder @ Apache Hop` should be on the right side
Also need to add photo
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Propose a feature</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a feature request</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Feature Proposal] <your idea>.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Improve documentation</td>
+ <td>
+ Click the edit icon in our documentation and it’ll take you to our <a href="https://github.com/apache/beam/">GitHub</a>, where you can automatically make the change you want and send a Pull Request.
+ </td>
+ </tr>
+ <tr>
+ <td>Improve the website</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Follow the website <a href="https://beam.apache.org/contribute/">Contribution Guide</a> to make changes yourself.</li>
+ <li>Check our <a href="https://issues.apache.org/jira/browse/BEAM-13229?jql=project%20%3D%20BEAM%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20website%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">Website Backlog</a> in Jira to find rooms for improvement areas, or propose one.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Write a blogpost</td>
+ <td>
+ Tell a story about your custom use cases or share your recommendations and best practices.
+ </td>
+ </tr>
+ <tr>
+ <td>Share your success story</td>
+ <td>
+ Visit our <a href="https://beam.apache.org/case-studies/">Case Studies</a> page and share your story or add your company’s logo.
+ </td>
+ </tr>
+ <tr>
+ <td>Produce a social media publication</td>
+ <td>
+ Share the use cases that Beam helps empower or the data processing performance you achieved. Spread the word about the upcoming Beam Summits and conferences.
+ </td>
+ </tr>
+ <tr>
+ <td>Organize an event</td>
+ <td>
+ Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> to share your idea about the Beam event you want to organize.
+ </td>
+ </tr>
+ <tr>
+ <td>Build a new feature like a new IO connector or PTransform</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Create and contribute a custom <a href="https://beam.apache.org/documentation/programming-guide/#pipeline-io">I/O connector</a> for a specific data storage system you want to connect to, if it is not on <a href="https://beam.apache.org/documentation/io/built-in/">the I/O list yet</a>.</li>
+ <li>Look at our project backlog to get some inspiration on what to build.</li>
+ <li>Follow our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Share a code sample or template</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Read our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ <li>Create your code sample or template. </li>
+ <li><a href="https://beam.apache.org/contribute/#make-your-change">Make a Pull Request</a> to add it to the Beam example folder.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Test a release candidate</td>
+ <td>
+ Anybody can <a href="https://beam.apache.org/contribute/release-guide/">propose a release</a> via the dev@beam.apache.org mailing list. Try Apache Beam releases in your projects, vote for release candidates, inform the community about the results and any issues found via <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>. Learn more about how to validate a Beam release <a href="https://beam.apache.org/blog/validate-beam-release/">here</a>.
+ </td>
+ </tr>
+ <tr>
+ <td>Other ideas?</td>
+ <td>
+ If you want to contribute in another way and you’re not sure how to get started, send a proposal to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>.
+ </td>
+ </tr>
+</table>
+
+
+## Become a Committer
+
+If you like contributing to Apache Beam, you are active in the Apache Beam mailing lists, Slack channel, or you attend/organize events, then you are a candidate to become a project committer.
+
+Committers are community members that have write access to the project’s repositories (i.e., they can modify the code, documentation, and website by themselves and also assist with code reviews and accept other contributions).
+
+Even though there is no strict protocol to become a committer, the most important thing we look for is that you display the traits of an Apache Beam committer and that you have been consistently contributing to the project and community.
+
+Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC team. So if you would like to become a committer, engage with the community and keep contributing to Apache Beam, you might also want to talk to other committers and ask for their advice and guidance. Feel free to email any committer directly and ask for their advice!
+
+## The Traits of an Apache Beam Committer
+
+{{< contributor/row_of_traits committer_traits >}}
+
+## Become a Project Management Committee (PMC) Member
+
+The PMC is the official managing body of the project as per the Apache Software Foundation governance model: “The Apache Way”. PMC members vote to set Apache Beam’s community and technical direction and are directly responsible for overseeing releases and the healthy development of the community.
+
+PMC members are also responsible for ensuring their project follows certain core requirements set by the board or other corporate officers of the ASF, like following Legal, Branding, and Infrastructure related requirements, along with ensuring their community operates within the [ASF Code of Conduct](https://www.apache.org/foundation/policies/conduct#code-of-conduct).
+
+Since the PMC members are responsible for establishing the Apache Beam vision and leading our community to work in harmony to achieve it, we look for committed individuals who can perform the responsibilities of the PMC, as well as lead our community to fulfill its vision. This is why we strive to build a diverse PMC that complements skills and expertise sharing the same sets of values.
+
+Ideally, we find candidates among active community members that have shown initiative to shape the direction of Beam and have shown willingness to learn the official processes, such as how to create or verify for releases, how to ensure trademark compliance for events, among others. We also expect PMC candidates to be level-headed, constructive, supportive, and willing to “disagree and commit” at times.
+
+A PMC member is also a committer, so if they are not initiated already, they will automatically become committers when joining the PMC. Therefore, the traits of Apache Beam committers also apply to PMC members.
+
+## Hear from the Community
+
+“Knowledge sharing and collaboration is something that comes naturally in the community. Together, we can work with the most complex problems and just solve them.
+”Matt Casters, Co-founder @ Apache Hop
+
+“I really enjoy working with Beam. The understanding of its internals empowers you to fine-tune the open source, customize it. Beam is very powerful and the abstraction is its most significant feature.”
+Talat Ulyarer, Sr Principal Software Engineer @ Palo Alto Networks
+
+“My takeaway: everyone should join the [Apache Beam] mailing lists! This is where all the discussions happen, and it is a great place for learning. I also encourage everyone to attend and participate in conferences to meet and connect with the community.”
+Tobias Kaymak, Senior Data Engineer @ Ricardo
Review comment:
`Tobias Kaymak, Senior Data Engineer @ Ricardo` should be on the right side
Also need to add photo
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
Review comment:
```suggestion
- Make an impact by bringing advanced technology solutions into reality
```
##########
File path: website/www/site/assets/scss/_contribute.sass
##########
@@ -0,0 +1,20 @@
+/*!
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.list-text-size-md
+ li
+ font-size: 14px
Review comment:
Add an empty line.
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
Review comment:
```suggestion
### What’s In It for You?
```
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
Review comment:
Why `## Contribute to Apache Beam` insted of `# Contribute to Apache Beam`?
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
Review comment:
`with subject: [Bug] <bug summary> and include` isn't shown on the page in right way:
<img width="234" alt="image" src="https://user-images.githubusercontent.com/26118465/159256420-580006e4-54e6-4aa4-8426-1d0dd37b8a57.png">
##########
File path: website/www/site/content/en/contribute/contribute.md
##########
@@ -0,0 +1,389 @@
+---
Review comment:
As I can see you add `Beam Contribution Guide` page (rewrite from previous one). Make sure that [[BEAM-13992](https://issues.apache.org/jira/browse/BEAM-13992)] changes are also included
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Propose a feature</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a feature request</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Feature Proposal] <your idea>.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Improve documentation</td>
+ <td>
+ Click the edit icon in our documentation and it’ll take you to our <a href="https://github.com/apache/beam/">GitHub</a>, where you can automatically make the change you want and send a Pull Request.
+ </td>
+ </tr>
+ <tr>
+ <td>Improve the website</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Follow the website <a href="https://beam.apache.org/contribute/">Contribution Guide</a> to make changes yourself.</li>
+ <li>Check our <a href="https://issues.apache.org/jira/browse/BEAM-13229?jql=project%20%3D%20BEAM%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20website%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC">Website Backlog</a> in Jira to find rooms for improvement areas, or propose one.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Write a blogpost</td>
+ <td>
+ Tell a story about your custom use cases or share your recommendations and best practices.
+ </td>
+ </tr>
+ <tr>
+ <td>Share your success story</td>
+ <td>
+ Visit our <a href="https://beam.apache.org/case-studies/">Case Studies</a> page and share your story or add your company’s logo.
+ </td>
+ </tr>
+ <tr>
+ <td>Produce a social media publication</td>
+ <td>
+ Share the use cases that Beam helps empower or the data processing performance you achieved. Spread the word about the upcoming Beam Summits and conferences.
+ </td>
+ </tr>
+ <tr>
+ <td>Organize an event</td>
+ <td>
+ Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> to share your idea about the Beam event you want to organize.
+ </td>
+ </tr>
+ <tr>
+ <td>Build a new feature like a new IO connector or PTransform</td>
+ <td class="list-text-size-md">
+ <ul>
+ <li>Create and contribute a custom <a href="https://beam.apache.org/documentation/programming-guide/#pipeline-io">I/O connector</a> for a specific data storage system you want to connect to, if it is not on <a href="https://beam.apache.org/documentation/io/built-in/">the I/O list yet</a>.</li>
+ <li>Look at our project backlog to get some inspiration on what to build.</li>
+ <li>Follow our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td>Share a code sample or template</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Read our <a href="https://beam.apache.org/contribute/">Code Contribution Guide</a>.</li>
+ <li>Create your code sample or template. </li>
+ <li><a href="https://beam.apache.org/contribute/#make-your-change">Make a Pull Request</a> to add it to the Beam example folder.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Test a release candidate</td>
+ <td>
+ Anybody can <a href="https://beam.apache.org/contribute/release-guide/">propose a release</a> via the dev@beam.apache.org mailing list. Try Apache Beam releases in your projects, vote for release candidates, inform the community about the results and any issues found via <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>. Learn more about how to validate a Beam release <a href="https://beam.apache.org/blog/validate-beam-release/">here</a>.
+ </td>
+ </tr>
+ <tr>
+ <td>Other ideas?</td>
+ <td>
+ If you want to contribute in another way and you’re not sure how to get started, send a proposal to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a>.
+ </td>
+ </tr>
+</table>
+
+
+## Become a Committer
+
+If you like contributing to Apache Beam, you are active in the Apache Beam mailing lists, Slack channel, or you attend/organize events, then you are a candidate to become a project committer.
+
+Committers are community members that have write access to the project’s repositories (i.e., they can modify the code, documentation, and website by themselves and also assist with code reviews and accept other contributions).
+
+Even though there is no strict protocol to become a committer, the most important thing we look for is that you display the traits of an Apache Beam committer and that you have been consistently contributing to the project and community.
+
+Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC team. So if you would like to become a committer, engage with the community and keep contributing to Apache Beam, you might also want to talk to other committers and ask for their advice and guidance. Feel free to email any committer directly and ask for their advice!
+
+## The Traits of an Apache Beam Committer
+
+{{< contributor/row_of_traits committer_traits >}}
+
+## Become a Project Management Committee (PMC) Member
+
+The PMC is the official managing body of the project as per the Apache Software Foundation governance model: “The Apache Way”. PMC members vote to set Apache Beam’s community and technical direction and are directly responsible for overseeing releases and the healthy development of the community.
+
+PMC members are also responsible for ensuring their project follows certain core requirements set by the board or other corporate officers of the ASF, like following Legal, Branding, and Infrastructure related requirements, along with ensuring their community operates within the [ASF Code of Conduct](https://www.apache.org/foundation/policies/conduct#code-of-conduct).
+
+Since the PMC members are responsible for establishing the Apache Beam vision and leading our community to work in harmony to achieve it, we look for committed individuals who can perform the responsibilities of the PMC, as well as lead our community to fulfill its vision. This is why we strive to build a diverse PMC that complements skills and expertise sharing the same sets of values.
+
+Ideally, we find candidates among active community members that have shown initiative to shape the direction of Beam and have shown willingness to learn the official processes, such as how to create or verify for releases, how to ensure trademark compliance for events, among others. We also expect PMC candidates to be level-headed, constructive, supportive, and willing to “disagree and commit” at times.
+
+A PMC member is also a committer, so if they are not initiated already, they will automatically become committers when joining the PMC. Therefore, the traits of Apache Beam committers also apply to PMC members.
+
+## Hear from the Community
+
+“Knowledge sharing and collaboration is something that comes naturally in the community. Together, we can work with the most complex problems and just solve them.
+”Matt Casters, Co-founder @ Apache Hop
+
+“I really enjoy working with Beam. The understanding of its internals empowers you to fine-tune the open source, customize it. Beam is very powerful and the abstraction is its most significant feature.”
+Talat Ulyarer, Sr Principal Software Engineer @ Palo Alto Networks
Review comment:
`Talat Ulyarer, Sr Principal Software Engineer @ Palo Alto Networks` should be on the right side
Also need to add photo
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -24,366 +24,165 @@ See the License for the specific language governing permissions and
limitations under the License.
-->
-# Contribution guide
+## Contribute to Apache Beam
+
+Apache Beam is an open source project developed and maintained by a friendly community of users, contributors, committers, and project management committee (PMC) members.
+
+Everyone is welcome to join and contribute to the project in multiple ways, not only with code contributions. Contributions like asking questions, reporting bugs, proposing new features, improving documentation, adding to the website, organizing events, or writing blog posts among other contributions, are welcome and recognized.
+
+### What’s In It for You?
+ - Become a part of the world’s largest, most welcoming open source community
+ - Drive innovation for next-gen distributed data processing
+ - Make an impact by bringing advanced technology solutions into reality
+ - Empower your brand recognition and thought leadership in the data world
+
+### Ways You Can Contribute
+
+Here’s a list of things you can do to get started contributing:
+
+<table class="table table-bordered">
+ <tr>
+ <th>Contribution</th>
+ <th>How to do it</th>
+ </tr>
+ <tr>
+ <td>Participate and share ideas</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Start by <a href="https://beam.apache.org/contribute/#accounts-and-permissions">getting an Apache Beam Jira account</a>.</li>
+ <li>Subscribe to our <a href="https://beam.apache.org/community/contact-us/">mailing lists</a> (<a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> and <a href="mailto:dev@beam.apache.org">user@beam.apache.org</a>).</li>
+ <li>Stay in the loop of our <a href="https://issues.apache.org/jira/projects/BEAM/issues">Jira product backlog</a>, participate in discussions to brainstorm solutions, and help the community solve their mailing list questions.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>File a bug</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a bug</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Bug] <bug summary> and include as much detail as possible.</li>
+ </ol>
+ </td>
+ </tr>
+ <tr>
+ <td>Propose a feature</td>
+ <td class="list-text-size-md">
+ <ol>
+ <li>Create a Jira ticket and mark it as a feature request</li>
+ <br>OR<br><br>
+ <li>Send an email to <a href="mailto:dev@beam.apache.org">dev@beam.apache.org</a> with subject: [Feature Proposal] <your idea>.</li>
Review comment:
`with subject: [Feature Proposal] <your idea>.` isn't shown on the page in right way:
<img width="235" alt="image" src="https://user-images.githubusercontent.com/26118465/159256644-4fbfe8a8-d813-4cfb-acc2-1dea7f0ba0be.png">
--
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.
To unsubscribe, e-mail: github-unsubscribe@beam.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org