[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160934=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160934 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 31/Oct/18 00:03 Start Date: 31/Oct/18 00:03 Worklog Time Spent: 10m Work Description: swegner commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-434514587 Jenkins is still down; I've validated locally that these changes pass precommit: https://gradle.com/s/4jvmexqsifibk 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160934) Time Spent: 6h 40m (was: 6.5h) > 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: 6h 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160935=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160935 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 31/Oct/18 00:03 Start Date: 31/Oct/18 00:03 Worklog Time Spent: 10m Work Description: swegner closed pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857 This is a PR merged from a forked repository. As GitHub hides the original diff on merge, it is displayed below for the sake of provenance: As this is a foreign pull request (from a fork), the diff is supplied below (as it won't show otherwise due to GitHub magic): diff --git a/website/src/_includes/section-menu/contribute.html b/website/src/_includes/section-menu/contribute.html index 657de6e2b3e..adb1d92cdd2 100644 --- a/website/src/_includes/section-menu/contribute.html +++ b/website/src/_includes/section-menu/contribute.html @@ -12,20 +12,20 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches @@ -37,8 +37,8 @@ Committers - +PMC and committers Become a committer Committer guide Release guide diff --git a/website/src/community/contact-us.md b/website/src/community/contact-us.md index 7b5651abe48..f431857e161 100644 --- a/website/src/community/contact-us.md +++ b/website/src/community/contact-us.md @@ -29,12 +29,14 @@ whichever one seems best! | How to contact us | When to use it | | - | ---| -| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org), [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)) | -| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org), [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)) | -| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org) mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org), [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)) | +| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?u...@beam.apache.org)) | +| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?d...@beam.apache.org)) | +| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org) mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?comm...@beam.apache.org)) | | [JIRA bug tracker](https://issues.apache.org/jira/browse/BEAM) | Report bugs / discover known issues | | [StackOverflow](http://stackoverflow.com/questions/tagged/apache-beam) | Ask and answer user support questions | | [Slack](https://s.apache.org/beam-slack-channel) | Chat with users and developers on channel #beam ([Join](https://s.apache.org/slack-invite)) | {:.table} +[^1]: To subscribe or unsubscribe, a blank email is fine. + If you wish to report a security vulnerability, please contact [secur...@apache.org](mailto:secur...@apache.org). Apache Beam follows the typical [Apache vulnerability handling process](https://apache.org/security/committers.html#vulnerability-handling). diff --git a/website/src/contribute/index.md b/website/src/contribute/index.md index 6b8473c01ef..27c3a9f0e33 100644 --- a/website/src/contribute/index.md +++ b/website/src/contribute/index.md @@ -7,8 +7,6 @@ redirect_from: - /contribution-guide/ - /contribute/contribution-guide/ - /docs/contribute/ - - /contribute/feature-branches/ - - /contribute/work-in-progress/ - /contribute/source-repository/ - /contribute/design-principles/ --- @@ -30,8 +28,17 @@ limitations under the License. The Apache Beam community welcomes contributions from anyone!
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160860=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160860 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 20:59 Start Date: 30/Oct/18 20:59 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229483852 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Development Environment + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE Review comment: Removed the list 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160860) Time Spent: 6h 20m (was: 6h 10m) > 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: 6h 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160862=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160862 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 20:59 Start Date: 30/Oct/18 20:59 Worklog Time Spent: 10m Work Description: alanmyrvold commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-434467448 Dropped the individual tip links and removed the extra footnote in contact-us 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160862) Time Spent: 6.5h (was: 6h 20m) > 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: 6.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160859=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160859 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 20:58 Start Date: 30/Oct/18 20:58 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229483790 ## File path: website/src/community/contact-us.md ## @@ -29,12 +29,14 @@ whichever one seems best! | How to contact us | When to use it | | - | ---| -| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org), [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)) | -| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org), [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)) | -| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org) mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org), [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)) | +| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?u...@beam.apache.org)) | +| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?d...@beam.apache.org)) | +| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org)[^1] mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?comm...@beam.apache.org)) | Review comment: Removed it 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160859) Time Spent: 6h 10m (was: 6h) > 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: 6h 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160756=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160756 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 18:19 Start Date: 30/Oct/18 18:19 Worklog Time Spent: 10m Work Description: tweise commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-434414299 Just one remaining comment to drop the individual tips links. Great work! 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160756) Time Spent: 6h (was: 5h 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: 6h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160755=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160755 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 18:18 Start Date: 30/Oct/18 18:18 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229428209 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Development Environment + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE Review comment: This list should be removed from here, since it is already on the wiki left nav: https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ (links could be repeated on the Wiki FAQ page as well) 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160755) Time Spent: 5h 50m (was: 5h 40m) > 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: 5h 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160742=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160742 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 17:24 Start Date: 30/Oct/18 17:24 Worklog Time Spent: 10m Work Description: swegner commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-434394422 This LGTM. I'll wait a bit to see if @tweise has any further comments before merging 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160742) Time Spent: 5h 40m (was: 5.5h) > 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: 5h 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160740=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160740 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 17:22 Start Date: 30/Oct/18 17:22 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_r229406491 ## File path: website/src/community/contact-us.md ## @@ -29,12 +29,14 @@ whichever one seems best! | How to contact us | When to use it | | - | ---| -| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org), [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)) | -| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org), [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)) | -| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org) mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org), [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)) | +| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?u...@beam.apache.org)) | +| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?d...@beam.apache.org)) | +| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org)[^1] mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?comm...@beam.apache.org)) | Review comment: This list has a footnote on the first column while the others don't. I recommend removing for consistency. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160740) Time Spent: 5.5h (was: 5h 20m) > 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: 5.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160739=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160739 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 17:21 Start Date: 30/Oct/18 17:21 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_r229406147 ## File path: website/src/community/contact-us.md ## @@ -29,12 +29,14 @@ whichever one seems best! | How to contact us | When to use it | | - | ---| -| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org), [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)) | -| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org), [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)) | -| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org) mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org), [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)) | +| [user@](https://lists.apache.org/list.html?u...@beam.apache.org) mailing list | User support and questions ([Subscribe](mailto:user-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:user-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?u...@beam.apache.org)) | +| [dev@](https://lists.apache.org/list.html?d...@beam.apache.org) mailing list | Development discussions ([Subscribe](mailto:dev-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:dev-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?d...@beam.apache.org)) | +| [commits@](https://lists.apache.org/list.html?comm...@beam.apache.org)[^1] mailing list | Firehose of commits, bugs, pull requests, etc. ([Subscribe](mailto:commits-subscr...@beam.apache.org)[^1], [Unsubscribe](mailto:commits-unsubscr...@beam.apache.org)[^1], [Archives](https://lists.apache.org/list.html?comm...@beam.apache.org)) | | [JIRA bug tracker](https://issues.apache.org/jira/browse/BEAM) | Report bugs / discover known issues | | [StackOverflow](http://stackoverflow.com/questions/tagged/apache-beam) | Ask and answer user support questions | | [Slack](https://s.apache.org/beam-slack-channel) | Chat with users and developers on channel #beam ([Join](https://s.apache.org/slack-invite)) | {:.table} +[^1]: To subscribe or unsubscribe, a blank email is fine. Review comment: This actually formats with a bunch of silly backlinks. Looks funny, but I don't know if it's worth looking into fixing. http://apache-beam-website-pull-requests.storage.googleapis.com/6857/community/contact-us/index.html#fnref:1 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160739) Time Spent: 5h 20m (was: 5h 10m) > 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: 5h 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160738=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160738 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 17:19 Start Date: 30/Oct/18 17:19 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_r229405279 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Development Environment + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE Review comment: I feel like this list will get stale quickly-- links will get moved/renamed without updating here (I already did that with IntelliJ), or people will add new Tips pages without also adding here. I don't mind too much as long as we don't expect this list to always match what's on the wiki. I'd be happy to just keep our "most important" tips pages linked here, for some measure of "most important" It would be cool if there was a Jekyll plugin to automatically come up with a link roll from Confluence during the build. From a quick Google search I don't see such a thing. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160738) Time Spent: 5h 10m (was: 5h) > 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: 5h 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160733=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160733 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 17:08 Start Date: 30/Oct/18 17:08 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229400926 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + Review comment: Done. Changed the website sidebar to Development Environment. Organized the tips pages in the wiki under the FAQ which is renamed Development Environment FAQ. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160733) Time Spent: 5h (was: 4h 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: 5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160604=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160604 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 13:00 Start Date: 30/Oct/18 13:00 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229294569 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + Review comment: Also, instead of "Tips" perhaps "Development Environment" would be more descriptive? 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160604) Time Spent: 4h 50m (was: 4h 40m) > 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: 4h 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160378=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160378 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 03:14 Start Date: 30/Oct/18 03:14 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229164593 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + Review comment: I think it would be nice to create a dedicated "Tips" page on the Wiki and relocate all these links over there. This would remove clutter from the left nav and make the Wiki space more self contained (new pages can be added there over time, existing renamed etc.). 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160378) Time Spent: 4h 40m (was: 4.5h) > 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: 4h 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160333=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160333 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 00:49 Start Date: 30/Oct/18 00:49 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229145877 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +Java development tips Review comment: Yup. IMO ease of editing trumps review for the tips; but policy related material needs to be on the web site. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160333) Time Spent: 4.5h (was: 4h 20m) > 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: 4.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160320=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160320 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 30/Oct/18 00:15 Start Date: 30/Oct/18 00:15 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229141229 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +Java development tips Review comment: Done. Moved all the tips to the wiki. There are pros + cons; I like the review process having these in github but it easier to edit as wiki pages. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160320) Time Spent: 4h 20m (was: 4h 10m) > 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: 4h 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160302=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160302 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 23:38 Start Date: 29/Oct/18 23:38 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229135028 ## File path: website/src/_includes/section-menu/contribute.html ## @@ -12,20 +12,33 @@ Contribute Get started contributing -https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +https://cwiki.apache.org/confluence/display/BEAM/Contribution+FAQ;>FAQ Technical Docs +Roadmap Testing guide - - Pre-commit Slowness Triage Guide - +Pre-commit Slowness Triage PTransform style guide Runner authoring guide Docker images Design documents Dependencies guide +Feature branches + + + + Tips + +https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE;>Using IntelliJ IDE +Java development tips Review comment: How about moving this tips section to the wiki is well? It would be easier to maintain / update there? 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160302) Time Spent: 4h 10m (was: 4h) > 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: 4h 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160300=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160300 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 23:33 Start Date: 29/Oct/18 23:33 Worklog Time Spent: 10m Work Description: alanmyrvold commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-434118897 @swegner PTAL 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160300) Time Spent: 4h (was: 3h 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: 4h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160299=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160299 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 23:33 Start Date: 29/Oct/18 23:33 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229134144 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,86 @@ +--- Review comment: Moved the FAQ to the wiki and updated the links 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160299) Time Spent: 3h 50m (was: 3h 40m) > 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: 3h 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160294=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160294 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 23:08 Start Date: 29/Oct/18 23:08 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229129562 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,86 @@ +--- Review comment: Now I have access. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160294) Time Spent: 3h 40m (was: 3.5h) > 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: 3h 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160221=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160221 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:38 Start Date: 29/Oct/18 21:38 Worklog Time Spent: 10m Work Description: tweise commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229108039 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,84 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Beam Contribution FAQ" +permalink: /contribute/FAQ/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. Review comment: @alanmyrvold you now have the wiki access 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160221) Time Spent: 3.5h (was: 3h 20m) > 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: 3.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160219=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160219 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:34 Start Date: 29/Oct/18 21:34 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229106931 ## File path: website/src/contribute/gradle-tips.md ## @@ -0,0 +1,63 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Gradle tips" +permalink: /contribute/gradle-tips/ +--- + + +# Gradle tips + +The [gradle](https://docs.gradle.org) build files are written using [Apache Groovy](http://groovy-lang.org/). + +Gradle targets can be specified with either the project name or directory, for example: + +$ ./gradlew :beam-website:serveWebsite + +is the same as + +$ ./gradlew -p website serveWebsite + +The mapping of directory to project name is in +[settings.gradle](https://github.com/apache/beam/blob/master/settings.gradle) + +To troubleshoot issues: +- the `--info` flag adds verbose logging +- the `--stacktrace` flag adds a stacktrace on failures +- the `--scan` flag creates a web scan page Review comment: Done 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160219) Time Spent: 3h 20m (was: 3h 10m) > 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: 3h 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160218=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160218 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:34 Start Date: 29/Oct/18 21:34 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229106859 ## File path: website/src/contribute/git-workflow.md ## @@ -0,0 +1,63 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Git workflow" +permalink: /contribute/git-workflow/ +--- + + +To propose code changes, you should be familiar with the Git / Github workflow, including: + - [forking](https://help.github.com/articles/fork-a-repo/) the + [github.com/apache/beam](https://github.com/apache/beam) repo + - [cloning](https://help.github.com/articles/cloning-a-repository/) your fork + - [syncing](https://help.github.com/articles/syncing-a-fork/) your master branch with the upstream apache/beam + repository + - [branching](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/) + - [squashing](https://help.github.com/articles/about-git-rebase/) commits + - [proposing changes](https://help.github.com/articles/proposing-changes-to-your-work-with-pull-requests/) in a pull + request + +For example, to create a pull request: + +1. [Fork](https://help.github.com/articles/fork-a-repo/) the [github.com/apache/beam](https://github.com/apache/beam) repo +1. [Clone](https://help.github.com/articles/cloning-a-repository/) your fork, for example: + + $ git clone g...@github.com:${GITHUB_USERNAME}/beam + $ cd beam + +1. Add an upstream remote for apache/beam to allow syncing changes into your fork + + $ git remote add upstream https://github.com/apache/beam + +1. Create a local branch for your changes + + $ git checkout -b someBranch + +1. Make your code change +1. Add unit tests for your change +1. Ensure tests pass locally +1. Commit your change with the name of the jira issue + + $ git add + $ git commit -am "[BEAM-] Description of change" + +1. Push your change to your forked repo + + $ git push --set-upstream origin YOUR_BRANCH_NAME + +1. Browse to the URL of your forked repository and propose a pull request. + +1. Find a committer to review, and @mention them in the review comments Review comment: Changed it to `R: @username` 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160218) Time Spent: 3h 10m (was: 3h) > 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: 3h 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160216=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160216 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:33 Start Date: 29/Oct/18 21:33 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229106684 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing 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 . +``` + +### 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: Changed the title. Added more detail to the contrib index.html 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160216) Time Spent: 3h (was: 2h 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: 3h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160215=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160215 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:32 Start Date: 29/Oct/18 21:32 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229106471 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. Review comment: Done, with a footnote and added link to archives 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160215) Time Spent: 2h 50m (was: 2h 40m) > 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: 2h 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160212=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160212 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:31 Start Date: 29/Oct/18 21:31 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229105990 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing to the Apache Beam SDK. I'd like to be added Review comment: Done. Removed the example and added a link. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160212) Time Spent: 2h 40m (was: 2.5h) > 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: 2h 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160209=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160209 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:31 Start Date: 29/Oct/18 21:31 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229105934 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,84 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Beam Contribution FAQ" +permalink: /contribute/FAQ/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. Review comment: Fixed. Also added a TODO to move this to the wiki/ 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160209) Time Spent: 2h 10m (was: 2h) > 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: 2h 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160210=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160210 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:31 Start Date: 29/Oct/18 21:31 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229105949 ## File path: website/src/contribute/index.md ## @@ -45,269 +51,180 @@ There are lots of opportunities: - improve your favorite language SDK (Java, Python, Go, etc) - improve specific runners (Apache Apex, Apache Flink, Apache Spark, Google Cloud Dataflow, etc) + - improve or add IO connectors - work on the core programming model (what is a Beam pipeline and how does it run?) - improve the developer experience on Windows + - adding answers to the [contribution FAQ]({{ site.baseurl }}/contribute/FAQ) + - organize local meetups of users or contributors to the Apache Beam SDK Most importantly, if you have an idea of how to contribute, then do it! -For a list of open starter tasks, check -[https://s.apache.org/beam-starter-tasks](https://s.apache.org/beam-starter-tasks). - -## Finding Help +## Prerequisites for contributing code + +To contribute code, you need + - a GitHub account + - a Linux, macOS, or Microsoft Windows development environment with Java JDK 8 installed + - [Docker](https://www.docker.com/) installed for some tasks including building worker containers and testing website + changes locally + - [Go](https://golang.org) 1.10 or later installed for Go SDK development + - Python, virtualenv, and tox installed for Python SDK development + - for large contributions, a signed [Individual Contributor License + Agreement](https://www.apache.org/licenses/icla.pdf) (ICLA) to the Apache + Software Foundation (ASF). + +## Submitting your first code change + +1. Subscribe to the [dev@ mailing list]({{ site.baseurl}}/community/contact-us/). Review comment: Made it softer, Consider subscribing to the dev@ mailing list, especially if you plan to make more than one change or the change will be large. All decisions happen on the public dev list. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160210) Time Spent: 2h 20m (was: 2h 10m) > 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: 2h 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160211=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160211 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:31 Start Date: 29/Oct/18 21:31 Worklog Time Spent: 10m Work Description: alanmyrvold commented on a change in pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#discussion_r229105970 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing 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 . +``` + +### 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: Review comment: Called it out in the main contrib guide and removed from the FAQ 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160211) Time Spent: 2.5h (was: 2h 20m) > 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: 2.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160201=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160201 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 29/Oct/18 21:21 Start Date: 29/Oct/18 21:21 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_r229103170 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,84 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Beam Contribution FAQ" +permalink: /contribute/FAQ/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. Review comment: Missing close tag makes this render as an empty page: http://apache-beam-website-pull-requests.storage.googleapis.com/6857/contribute/FAQ/index.html 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160201) Time Spent: 1h 50m (was: 1h 40m) > 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 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160074=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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing 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 . +``` + +### 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: us...@infra.apache.org 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160079=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160079 ] 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_r229015660 ## File path: website/src/contribute/git-workflow.md ## @@ -0,0 +1,63 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Git workflow" +permalink: /contribute/git-workflow/ +--- + + +To propose code changes, you should be familiar with the Git / Github workflow, including: + - [forking](https://help.github.com/articles/fork-a-repo/) the + [github.com/apache/beam](https://github.com/apache/beam) repo + - [cloning](https://help.github.com/articles/cloning-a-repository/) your fork + - [syncing](https://help.github.com/articles/syncing-a-fork/) your master branch with the upstream apache/beam + repository + - [branching](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/) + - [squashing](https://help.github.com/articles/about-git-rebase/) commits + - [proposing changes](https://help.github.com/articles/proposing-changes-to-your-work-with-pull-requests/) in a pull + request + +For example, to create a pull request: + +1. [Fork](https://help.github.com/articles/fork-a-repo/) the [github.com/apache/beam](https://github.com/apache/beam) repo +1. [Clone](https://help.github.com/articles/cloning-a-repository/) your fork, for example: + + $ git clone g...@github.com:${GITHUB_USERNAME}/beam + $ cd beam + +1. Add an upstream remote for apache/beam to allow syncing changes into your fork + + $ git remote add upstream https://github.com/apache/beam + +1. Create a local branch for your changes + + $ git checkout -b someBranch + +1. Make your code change +1. Add unit tests for your change +1. Ensure tests pass locally +1. Commit your change with the name of the jira issue + + $ git add + $ git commit -am "[BEAM-] Description of change" + +1. Push your change to your forked repo + + $ git push --set-upstream origin YOUR_BRANCH_NAME + +1. Browse to the URL of your forked repository and propose a pull request. + +1. Find a committer to review, and @mention them in the review comments Review comment: We have differing conventions on how to request a reviewer throughout our contributor guide. I'd suggest we formalize on the more explicit `R: @mention`; this will help humans and tools differentiate what you're asking the individual to do. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160079) Time Spent: 1.5h (was: 1h 20m) > 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: 1.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160078=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160078 ] 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_r229016093 ## File path: website/src/contribute/gradle-tips.md ## @@ -0,0 +1,63 @@ +--- +layout: section +section_menu: section-menu/contribute.html +title: "Gradle tips" +permalink: /contribute/gradle-tips/ +--- + + +# Gradle tips + +The [gradle](https://docs.gradle.org) build files are written using [Apache Groovy](http://groovy-lang.org/). + +Gradle targets can be specified with either the project name or directory, for example: + +$ ./gradlew :beam-website:serveWebsite + +is the same as + +$ ./gradlew -p website serveWebsite + +The mapping of directory to project name is in +[settings.gradle](https://github.com/apache/beam/blob/master/settings.gradle) + +To troubleshoot issues: +- the `--info` flag adds verbose logging +- the `--stacktrace` flag adds a stacktrace on failures +- the `--scan` flag creates a web scan page Review comment: [..] creates a [Gradle Build Scan](https://guides.gradle.org/creating-build-scans/) 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160078) Time Spent: 1h 20m (was: 1h 10m) > 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 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160080=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160080 ] 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_r229011535 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing 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 . +``` + +### 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: Review comment: Finding reviewers is a core developer workflow; I think this should be called out in the main Contributor Guide rather than the FAQ. If we find we need the FAQ entry because the Contributor Guide isn't discoverable, then the FAQ answer should link to the existing content rather than duplicating. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160080) Time Spent: 1h 40m (was: 1.5h) > 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 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160077=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160077 ] 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_r229017050 ## File path: website/src/contribute/index.md ## @@ -45,269 +51,180 @@ There are lots of opportunities: - improve your favorite language SDK (Java, Python, Go, etc) - improve specific runners (Apache Apex, Apache Flink, Apache Spark, Google Cloud Dataflow, etc) + - improve or add IO connectors - work on the core programming model (what is a Beam pipeline and how does it run?) - improve the developer experience on Windows + - adding answers to the [contribution FAQ]({{ site.baseurl }}/contribute/FAQ) + - organize local meetups of users or contributors to the Apache Beam SDK Most importantly, if you have an idea of how to contribute, then do it! -For a list of open starter tasks, check -[https://s.apache.org/beam-starter-tasks](https://s.apache.org/beam-starter-tasks). - -## Finding Help +## Prerequisites for contributing code + +To contribute code, you need + - a GitHub account + - a Linux, macOS, or Microsoft Windows development environment with Java JDK 8 installed + - [Docker](https://www.docker.com/) installed for some tasks including building worker containers and testing website + changes locally + - [Go](https://golang.org) 1.10 or later installed for Go SDK development + - Python, virtualenv, and tox installed for Python SDK development + - for large contributions, a signed [Individual Contributor License + Agreement](https://www.apache.org/licenses/icla.pdf) (ICLA) to the Apache + Software Foundation (ASF). + +## Submitting your first code change + +1. Subscribe to the [dev@ mailing list]({{ site.baseurl}}/community/contact-us/). Review comment: I'm not sure I would list this as a step in submitting a code change; this is useful if you plan to be a repeat contributor or want to make some deep changes; but if you have something small I don't believe you should need to make a long-term commitment to the community. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160077) > 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 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160073=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160073 ] 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_r229006916 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. + +### 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 . I am interested in contributing to the Apache Beam SDK. I'd like to be added Review comment: I really like that you've given a template email; it lowers the bar a bit for reaching out to the community for the first time. It could be hard to fill in the open-ended "what" in `I'm interested in contributing [..]`; how about linking to a previous example email, like [this one](https://lists.apache.org/thread.html/e6018c2aaf7dc7895091434295e5b0fafe192b975e3e3761fcf0cda7@%3Cdev.beam.apache.org%3E)? 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160073) Time Spent: 50m (was: 40m) > 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: 50m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160076=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160076 ] 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_r229002534 ## File path: website/src/contribute/FAQ.md ## @@ -0,0 +1,86 @@ +--- Review comment: I'd prefer the FAQ to live on the wiki; the wiki is still easier to contribute to (the WYSIWYG editor is quite nice), and for an FAQ we should prioritize making it easy for anyone to add or modify content for the issue they're having. Another benefit of the wiki is that it's searchable, which is really nice searching on an error message. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160076) > 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 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=160075=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-160075 ] 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_r229005508 ## 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/ +--- + + +## Apache Beam Contribution FAQ + +Frequently asked questions about contributing to Apache Beam. + +### Who do I ask if I am stuck? + +Either email [d...@beam.apache.org]({{ 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 dev-subscr...@beam.apache.org. Review comment: Would this be better inline on the Contact Us page? Perhaps in a [footnote](https://kramdown.gettalong.org/syntax.html#footnotes) to not clutter the existing table. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 160075) Time Spent: 1h 10m (was: 1h) > 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 10m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=159734=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-159734 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 28/Oct/18 17:09 Start Date: 28/Oct/18 17:09 Worklog Time Spent: 10m Work Description: tweise commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-433723244 @alanmyrvold Thanks for working on this! I think it would be good to bring more visibility to this effort by sending an email to the list. I also think that most of this material should live on the Wiki. 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 159734) Time Spent: 40m (was: 0.5h) > 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: 40m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=159511=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-159511 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 27/Oct/18 03:43 Start Date: 27/Oct/18 03:43 Worklog Time Spent: 10m Work Description: alanmyrvold commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-433587598 http://apache-beam-website-pull-requests.storage.googleapis.com/6857/contribute/index.html 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 159511) Time Spent: 0.5h (was: 20m) > 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: 0.5h > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=159510=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-159510 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 27/Oct/18 03:41 Start Date: 27/Oct/18 03:41 Worklog Time Spent: 10m Work Description: alanmyrvold commented on issue #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857#issuecomment-433587518 @swegner PTAL? 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: us...@infra.apache.org Issue Time Tracking --- Worklog Id: (was: 159510) Time Spent: 20m (was: 10m) > 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: 20m > 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)
[jira] [Work logged] (BEAM-5735) Contributor Guide Improvements
[ https://issues.apache.org/jira/browse/BEAM-5735?focusedWorklogId=159484=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-159484 ] ASF GitHub Bot logged work on BEAM-5735: Author: ASF GitHub Bot Created on: 27/Oct/18 01:15 Start Date: 27/Oct/18 01:15 Worklog Time Spent: 10m Work Description: alanmyrvold opened a new pull request #6857: [BEAM-5735] Contributor guide improvements URL: https://github.com/apache/beam/pull/6857 [BEAM-5735] Contributor guide improvements [BEAM-5736] List prerequisite knowledge with links to external docs [BEAM-5737] Create a contributor FAQ page [BEAM-5738] Refactor Contributor Guide into "Stories" [BEAM-5739] Contributor Story: "Submitting your first PR" [BEAM-5740] Refactor permissions section into bullet-points Follow this checklist to help us incorporate your contribution quickly and easily: - [ ] Format the pull request title like `[BEAM-XXX] Fixes bug in ApproximateQuantiles`, where you replace `BEAM-XXX` with the appropriate JIRA issue, if applicable. This will automatically link the pull request to the issue. - [ ] If this contribution is large, please file an Apache [Individual Contributor License Agreement](https://www.apache.org/licenses/icla.pdf). It will help us expedite review of your Pull Request if you tag someone (e.g. `@username`) to look at it. Post-Commit Tests Status (on master branch) Lang | SDK | Apex | Dataflow | Flink | Gearpump | Samza | Spark --- | --- | --- | --- | --- | --- | --- | --- Go | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Go_GradleBuild/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Go_GradleBuild/lastCompletedBuild/) | --- | --- | --- | --- | --- | --- Java | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_GradleBuild/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_GradleBuild/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Apex_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Apex_Gradle/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Dataflow_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Dataflow_Gradle/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Flink_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Flink_Gradle/lastCompletedBuild/) [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_PVR_Flink/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_PVR_Flink/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Gearpump_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Gearpump_Gradle/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Samza_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Samza_Gradle/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Spark_Gradle/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Java_ValidatesRunner_Spark_Gradle/lastCompletedBuild/) Python | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Python_Verify/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Python_Verify/lastCompletedBuild/) | --- | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Py_VR_Dataflow/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Py_VR_Dataflow/lastCompletedBuild/) [![Build Status](https://builds.apache.org/job/beam_PostCommit_Py_ValCont/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Py_ValCont/lastCompletedBuild/) | [![Build Status](https://builds.apache.org/job/beam_PostCommit_Python_VR_Flink/lastCompletedBuild/badge/icon)](https://builds.apache.org/job/beam_PostCommit_Python_VR_Flink/lastCompletedBuild/) | --- | --- | --- 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: