[
https://issues.apache.org/jira/browse/BEAM-13992?focusedWorklogId=746592&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-746592
]
ASF GitHub Bot logged work on BEAM-13992:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 23/Mar/22 14:01
Start Date: 23/Mar/22 14:01
Worklog Time Spent: 10m
Work Description: dariabezkorovaina commented on a change in pull request
#17089:
URL: https://github.com/apache/beam/pull/17089#discussion_r833304655
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -57,46 +57,98 @@ There are lots of opportunities to contribute. You can for
example:
https://cwiki.apache.org/confluence/display/BEAM/Contributor+FAQ)
- organize local meetups of users or contributors to Apache Beam
+Below is a tutorial for contributing code to Beam, covering our tools and
typical process in
+detail.
+
</div>
-<a class="arrow-list-header" data-toggle="collapse"
href="#collapseContributing" role="button" aria-expanded="false"
aria-controls="collapseContributing">
- {{< figure src="/images/arrow-icon_list.svg">}}
+## Get Started
-## Contributing code
+### Connect with the Beam community
- </a>
+1. Consider [subscribing to the [email protected]](/community/contact-us/)
mailing list, especially if you plan to make more than one change or the change
will be large. All decisions are consensus-based and happen on the public
mailing list.
+1. (Optionally) Join the [#beam channel of the ASF
slack](https://beam.apache.org/community/contact-us/).
+1. Create an account on [Beam issue tracker
(JIRA)](https://issues.apache.org/jira/projects/BEAM/issues)
+ (anyone can do this).
-<div class="collapse dont-collapse-sm" id="collapseContributing">
+### Accounts and Permissions
-Below is a tutorial for contributing code to Beam, covering our tools and
typical process in
-detail.
+- [Beam issue tracker
(JIRA)](https://issues.apache.org/jira/projects/BEAM/issues):
+ Anyone can access it and browse issues. Anyone can register an account and
login
+ to create issues or add comments. Only contributors can be assigned issues.
If
+ you want to be assigned issues, a PMC member can add you to the project
contributor
+ group. Email the [[email protected]](/community/contact-us)
+ to ask to be added as a contributor in the Beam issue tracker, and include
your ASF Jira username.
+
+- [Beam Wiki
Space](https://cwiki.apache.org/confluence/display/BEAM/Apache+Beam):
+ Anyone has read access. If you wish to contribute changes, please create an
account and request edit access on the
+ [[email protected]](https://beam.apache.org/community/contact-us) mailing
list (include your Wiki account user ID).
+
+- Pull requests can only be merged by a
+ [Beam committer](https://home.apache.org/phonebook.html?pmc=beam).
+
+- [Voting on a release](https://www.apache.org/foundation/voting.html):
Everyone can vote. Only
+ [Beam PMC](https://home.apache.org/phonebook.html?pmc=beam) members should
mark their votes as binding.
+
+### Communication
+
+All communication is expected to align with the [Code of
Conduct](https://www.apache.org/foundation/policies/conduct).
+
+Discussion about contributing code to Beam happens on the
[[email protected] mailing list](/community/contact-us/). Introduce yourself!
+
+Questions can be asked on the [#beam channel of the ASF
slack](https://beam.apache.org/community/contact-us/). Introduce yourself!
+
+<a class="arrow-list-header" data-toggle="collapse"
href="#collapseContributing" role="button" aria-expanded="false"
aria-controls="collapseContributing">
+
+{{< figure src="/images/arrow-icon_list.svg">}}
+
+## Before You Begin
+
+</a>
### Prerequisites
- - A GitHub account.
- - A Linux, macOS, or Microsoft Windows development environment
- - Java JDK 8 installed
- - [Docker](https://www.docker.com/) installed for some tasks including
building worker containers and testing this website
- changes locally.
- - For SDK Development:
- - [Go](https://golang.org) 1.12 or later installed for Go SDK development
- - Python 3.x interpreters. You will need Python interpreters for all
Python versions supported by Beam.
- Interpreters should be installed and available in shell via
`python3.x` commands. For more information, see:
- Python installation tips in [Developer
Wiki](https://cwiki.apache.org/confluence/display/BEAM/Python+Tips#PythonTips-InstallingPythoninterpreters).
- - For large contributions, a signed [Individual Contributor License
- Agreement](https://www.apache.org/licenses/icla.pdf) (ICLA) to the Apache
- Software Foundation (ASF).
-
-
-### Configuration options
+- A [GitHub](https://github.com/) account.
+- A Linux, macOS, or Microsoft Windows development environment
+- Java JDK 8 installed
+- [Docker](https://www.docker.com/) installed for some tasks including
building worker containers and testing this website
+ changes locally.
+- For SDK Development:
+ - [Go](https://golang.org) 1.12 or later installed for Go SDK development
+ - Python 3.x interpreters. You will need Python interpreters for all Python
versions supported by Beam.
+ Interpreters should be installed and available in shell via `python3.x`
commands. For more information, see:
+ Python installation tips in [Developer
Wiki](https://cwiki.apache.org/confluence/display/BEAM/Python+Tips#PythonTips-InstallingPythoninterpreters).
+- For large contributions, a signed [Individual Contributor License
+ Agreement](https://www.apache.org/licenses/icla.pdf) (ICLA) to the Apache
+ Software Foundation (ASF).
Review comment:
Add dots after bullet points for consistency
--
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]
Issue Time Tracking
-------------------
Worklog Id: (was: 746592)
Time Spent: 4h 40m (was: 4.5h)
> [Website] Update Contribute/Code Contribution Guide page
> --------------------------------------------------------
>
> Key: BEAM-13992
> URL: https://issues.apache.org/jira/browse/BEAM-13992
> Project: Beam
> Issue Type: Improvement
> Components: website
> Reporter: Aydar Zaynutdinov
> Assignee: Bulat Safiullin
> Priority: P3
> Labels: website, website-update-sprint-2
> Time Spent: 4h 40m
> Remaining Estimate: 0h
>
> Need to update Contribute/Code Contribution Guide page according to TDD:
> # _Overview_
> # _Get Started:_
> ## _Connect with the Beam Community_
> ## _Accounts and Permissions_
> ## _Communication_
> # _Before You Begin:_
> ## _Prerequisites_
> ## _Share Your Intent_
> ## _Setup Your Environment:_
> ### _Configuration Options:_
> #### _Local: Debian-based Distribution_
> #### _Container: Docker-based_
> ### _Development Setup_
> # _Contribute Code:_
> ## _Create a Pull Request_
> ## _Review Process and Releases_
> ## Troubleshooting
> # _Find Efforts to Contribute to_
> # _Additional Resources_
> _Adding contributing guide feedback link
> [https://lists.apache.org/thread/tpy22xmrrdyqpc88l7hlcqp5m59n1v8h|https://www.google.com/url?q=https://lists.apache.org/thread/tpy22xmrrdyqpc88l7hlcqp5m59n1v8h&sa=D&source=docs&ust=1647372754175705&usg=AOvVaw2hJOPVm5hWsKs0hW0lWDTg]_
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
