[
https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160074&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160074
]
ASF GitHub Bot logged work on BEAM-5735:
----------------------------------------
Author: ASF GitHub Bot
Created on: 29/Oct/18 17:10
Start Date: 29/Oct/18 17:10
Worklog Time Spent: 10m
Work Description: swegner commented on a change in pull request #6857:
[BEAM-5735] Contributor guide improvements
URL: https://github.com/apache/beam/pull/6857#discussion_r229014478
##########
File path: website/src/contribute/FAQ.md
##########
@@ -0,0 +1,86 @@
+---
+layout: section
+section_menu: section-menu/contribute.html
+title: "Beam Contribution FAQ"
+permalink: /contribute/FAQ/
+---
+<!--
+Licensed 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.
+-->
+
+## Apache Beam Contribution FAQ
+
+Frequently asked questions about contributing to Apache Beam.
+
+### Who do I ask if I am stuck?
+
+Either email [[email protected]]({{ site.baseurl }}/community/contact-us/)
or chat
+on [Slack]({{ site.baseurl }}/community/contact-us/).
+
+### How do I join the dev email list?
+
+Send a blank email to [email protected].
+
+### Why can't I assign a jira issue to myself?
+
+Only ASF Jira contributors can be assigned issues. To get the permission to do
so, email
+the [dev@ mailing list]({{ site.baseurl }}/community/contact-us)
+to ask to be a contributor in the Beam issue tracker. For example:
+
+```
+Hi, my name is <your name>. I am interested in contributing <what> to the
Apache Beam SDK. I'd like to be added
+as a Jira contributor so that I can assign issues to myself. My ASF Jira
Username is <username>.
+```
+
+### OutOfMemoryException during the Gradle build
+
+You might get an OutOfMemoryException during the Gradle build. If you have
more memory
+available, you can try to increase the memory allocation of the Gradle JVM.
Otherwise,
+disabling parallel test execution reduces memory consumption. In the root of
the Beam
+source, edit the `gradle.properties` file and add/modify the following lines:
+
+ org.gradle.parallel=false
+ org.gradle.jvmargs=-Xmx2g -XX:MaxPermSize=512m
+
+### Finding reviewers
+
+Currently this is a manual process. Tracking bug for automating this:
+[BEAM-4790](https://issues.apache.org/jira/browse/BEAM-4790).
+
+Reviewers for [apache/beam](https://github.com/apache/beam) are listed in
+Prow-style OWNERS files. A description of these files can be found
+[here](https://go.k8s.io/owners).
+
+For each file to be reviewed, look for an OWNERS file in its directory. Pick a
+single reviewer from that file. If the directory doesn't contain an OWNERS
file,
+go up a directory. Keep going until you find one. Try to limit the number of
+reviewers to 2 per PR if possible, to minimize reviewer load. Comment on your
PR
+tagging the reviewer as follows:
+
+ R: @reviewer
+
+### Adding yourself as a reviewer
Review comment:
From the heading it sounds like this could be about adding yourself as a
reviewer for a specific PR. Maybe change it to something like:
Opt-in to reviewing pull requests
And this also seems like a core developer workflow rather than a FAQ. I'd
love if we found a better place to organize it. (But if there isn't an existing
place, getting it documented here is better than nothing)
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
Issue Time Tracking
-------------------
Worklog Id: (was: 160074)
Time Spent: 1h (was: 50m)
> Contributor Guide Improvements
> ------------------------------
>
> Key: BEAM-5735
> URL: https://issues.apache.org/jira/browse/BEAM-5735
> Project: Beam
> Issue Type: Improvement
> Components: website
> Reporter: Scott Wegner
> Assignee: Alan Myrvold
> Priority: Major
> Time Spent: 1h
> Remaining Estimate: 0h
>
> This is a wish-list for improvements to the Beam contributor guide.
> Many thanks to [~rohdesam] for the feedback which helped shape this list.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
