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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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 [email protected] 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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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 [email protected] 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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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 [email protected] 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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</a> and <a
href="mailto:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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:[email protected]";>[email protected]</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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
![https://user-images.githubusercontent.com/26118465/159256420-580006e4-54e6-4aa4-8426-1d0dd37b8a57.png"](https://user-images.githubusercontent.com/26118465/159256420-580006e4-54e6-4aa4-8426-1d0dd37b8a57.png"){kind=link}
![https://user-images.githubusercontent.com/26118465/159256644-4fbfe8a8-d813-4cfb-acc2-1dea7f0ba0be.png"](https://user-images.githubusercontent.com/26118465/159256644-4fbfe8a8-d813-4cfb-acc2-1dea7f0ba0be.png"){kind=link}