beam-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From git-site-r...@apache.org
Subject [beam] branch asf-site updated: Publishing website 2018/11/02 20:48:33 at commit f0baa40
Date Fri, 02 Nov 2018 20:48:38 GMT
This is an automated email from the ASF dual-hosted git repository.

git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/beam.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 9a268a4  Publishing website 2018/11/02 20:48:33 at commit f0baa40
9a268a4 is described below

commit 9a268a4bfd35495789eebb337b068e37251eee10
Author: jenkins <builds@apache.org>
AuthorDate: Fri Nov 2 20:48:33 2018 +0000

    Publishing website 2018/11/02 20:48:33 at commit f0baa40
---
 .../contribute/become-a-committer/index.html       |  5 +-
 .../contribute/committer-guide/index.html          |  5 +-
 .../contribute/dependencies/index.html             |  5 +-
 .../contribute/design-documents/index.html         |  5 +-
 .../contribute/docker-images/index.html            |  5 +-
 .../contribute/feature-branches/index.html         |  5 +-
 .../{precommit-policies => get-help}/index.html    | 81 +++-------------------
 website/generated-content/contribute/index.html    | 73 ++++++++++++-------
 .../contribute/postcommits-guides/index.html       |  5 +-
 .../postcommits-policies-details/index.html        |  5 +-
 .../contribute/postcommits-policies/index.html     |  5 +-
 .../contribute/precommit-policies/index.html       |  5 +-
 .../contribute/precommit-triage-guide/index.html   |  5 +-
 .../contribute/ptransform-style-guide/index.html   |  5 +-
 .../contribute/release-guide/index.html            |  5 +-
 .../contribute/runner-guide/index.html             |  5 +-
 .../contribute/testing/index.html                  |  5 +-
 .../get-started/beam-overview/index.html           |  2 +-
 18 files changed, 72 insertions(+), 159 deletions(-)

diff --git a/website/generated-content/contribute/become-a-committer/index.html b/website/generated-content/contribute/become-a-committer/index.html
index f0f76ca..a9e47b8 100644
--- a/website/generated-content/contribute/become-a-committer/index.html
+++ b/website/generated-content/contribute/become-a-committer/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/committer-guide/index.html b/website/generated-content/contribute/committer-guide/index.html
index 25a601f..5974a9c 100644
--- a/website/generated-content/contribute/committer-guide/index.html
+++ b/website/generated-content/contribute/committer-guide/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/dependencies/index.html b/website/generated-content/contribute/dependencies/index.html
index b12785e..6ad5574 100644
--- a/website/generated-content/contribute/dependencies/index.html
+++ b/website/generated-content/contribute/dependencies/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/design-documents/index.html b/website/generated-content/contribute/design-documents/index.html
index 1345584..511d782 100644
--- a/website/generated-content/contribute/design-documents/index.html
+++ b/website/generated-content/contribute/design-documents/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/docker-images/index.html b/website/generated-content/contribute/docker-images/index.html
index bef0076..6667146 100644
--- a/website/generated-content/contribute/docker-images/index.html
+++ b/website/generated-content/contribute/docker-images/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/feature-branches/index.html b/website/generated-content/contribute/feature-branches/index.html
index 903dfdd..1fd1268 100644
--- a/website/generated-content/contribute/feature-branches/index.html
+++ b/website/generated-content/contribute/feature-branches/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/precommit-policies/index.html b/website/generated-content/contribute/get-help/index.html
similarity index 85%
copy from website/generated-content/contribute/precommit-policies/index.html
copy to website/generated-content/contribute/get-help/index.html
index 7040441..a65b230 100644
--- a/website/generated-content/contribute/precommit-policies/index.html
+++ b/website/generated-content/contribute/get-help/index.html
@@ -28,7 +28,7 @@
   <meta charset="utf-8">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Pre-commit Test Policies</title>
+  <title>Get Help Contributing</title>
   <meta name="description" content="Apache Beam is an open source, unified model and set of language-specific SDKs for defining and executing data processing workflows, and also data ingestion and integration flows, supporting Enterprise Integration Patterns (EIPs) and Domain Specific Languages (DSLs). Dataflow pipelines simplify the mechanics of large-scale batch and streaming data processing and can run on a number of runtimes like Apache Flink, Apache Spark, and Google Cloud Dataflow  [...]
 ">
   <link href="https://fonts.googleapis.com/css?family=Roboto:100,300,400" rel="stylesheet">
@@ -39,7 +39,7 @@
   <script src="/js/fix-menu.js"></script>
   <script src="/js/section-nav.js"></script>
   <script src="/js/page-nav.js"></script>
-  <link rel="canonical" href="https://beam.apache.org/contribute/precommit-policies/" data-proofer-ignore>
+  <link rel="canonical" href="https://beam.apache.org/contribute/get-help/" data-proofer-ignore>
   <link rel="shortcut icon" type="image/x-icon" href="/images/favicon.ico">
   <link rel="alternate" type="application/rss+xml" title="Apache Beam" href="https://beam.apache.org/feed.xml">
   <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.4.1/css/all.css" integrity="sha384-5sAR7xN1Nv6T6+dT2mhtzEpVJvfS3NScPQTrOxhwjIuvcA67KV2R5Jz6kr4abQsz" crossorigin="anonymous">
@@ -120,7 +120,7 @@
           </ul>
         </li>
         <li>
-          <a href="https://github.com/apache/beam/edit/master/website/src/contribute/precommit-policies.md">
+          <a href="https://github.com/apache/beam/edit/master/website/src/contribute/get-help.md">
             <i class="far fa-edit fa-lg" alt="Edit on GitHub" title="Edit on GitHub"></i>
           </a>
         </li>
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
@@ -200,16 +197,6 @@
 
 
 
-<ul class="nav">
-  <li><a href="#definitions">Definitions</a></li>
-  <li><a href="#policies">Policies</a>
-    <ul>
-      <li><a href="#pull-requests">Pull Requests</a></li>
-      <li><a href="#problems">Problems</a></li>
-      <li><a href="#problem-resolution">Problem Resolution</a></li>
-    </ul>
-  </li>
-</ul>
 
 
       </nav>
@@ -229,66 +216,16 @@ See the License for the specific language governing permissions and
 limitations under the License.
 -->
 
-<h1 id="pre-commit-test-policies">Pre-commit test policies</h1>
-
-<h2 id="definitions">Definitions</h2>
-
-<ul>
-  <li>Pre-commit test - Any single test in a pre-commit test suite.</li>
-  <li>Pre-commit test suite - A collection of pre-commit tests that have a common
-denominator. A test suite runs in a single Jenkins job. Currently, suites are
-grouped by SDK languages, e.g., Python, Java, and Go.</li>
-</ul>
-
-<h2 id="policies">Policies</h2>
-
-<h3 id="pull-requests">Pull Requests</h3>
-
-<ul>
-  <li>A PR must pass pre-commit tests before being committed to the main Beam repo.
-    <ul>
-      <li>The relevant pre-commit test suites are automatically launched according to
-PR contents.</li>
-    </ul>
-  </li>
-</ul>
-
-<h3 id="problems">Problems</h3>
-
-<h4 id="breakage">Breakage</h4>
+<h1 id="get-help-contributing">Get Help Contributing</h1>
 
-<p>Breakage is when one or more tests in a pre-commit test suite fails or
-is flaky (occasionally fails).</p>
+<p>If you have any trouble contributing, don’t give up!</p>
 
 <ul>
-  <li>Breakages should be fixed within 8 hours.</li>
+  <li>Check the <a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ" target="_blank">FAQ on our developers’ wiki <img src="/images/external-link-icon.png" alt="External link to Beam developers' Wiki" width="14px" /></a>.</li>
+  <li>Send email to the Beam developer community on <a href="/community/contact-us">dev@beam.apache.org</a></li>
+  <li>Find someone to chat with in realtime at <a href="/community/contact-us">#beam on Slack</a>.</li>
 </ul>
 
-<h4 id="slowness">Slowness</h4>
-
-<p>Slowness is when the total time to run a pre-commit suite exceeds 30 minutes*,
-including the time the job spends in the Jenkins queue.</p>
-
-<ul>
-  <li>Slowness should be fixed within 24 hours.</li>
-</ul>
-
-<p>* See the <a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage
-Guide</a> for a precise definition of slowness
-and for information on dealing with slowness.</p>
-
-<h3 id="problem-resolution">Problem Resolution</h3>
-
-<p>For any problem, the options are, one of:</p>
-
-<ul>
-  <li>Roll back the culprit PR.</li>
-  <li>Roll out a fix within 24 hours.</li>
-  <li>Disable the slow test or feature temporarily (make sure there’s a tracking
-issue to re-enable it).</li>
-</ul>
-
-
       </div>
     </div>
     <!--
diff --git a/website/generated-content/contribute/index.html b/website/generated-content/contribute/index.html
index 3912b42..edb1b65 100644
--- a/website/generated-content/contribute/index.html
+++ b/website/generated-content/contribute/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
@@ -202,7 +199,14 @@
 
 <ul class="nav">
   <li><a href="#prerequisites-for-contributing-code">Prerequisites for contributing code</a></li>
-  <li><a href="#submitting-your-first-code-change">Submitting your first code change</a></li>
+  <li><a href="#contributing-code">Contributing code</a>
+    <ul>
+      <li><a href="#connect-with-the-beam-community">Connect With the Beam community</a></li>
+      <li><a href="#share-your-intent">Share your intent</a></li>
+      <li><a href="#development-setup">Development Setup</a></li>
+      <li><a href="#make-your-change">Make your change</a></li>
+    </ul>
+  </li>
   <li><a href="#when-will-my-change-show-up-in-an-apache-beam-release">When will my change show up in an Apache Beam release?</a></li>
   <li><a href="#stale-pull-requests">Stale pull requests</a></li>
   <li><a href="#accounts-and-permissions">Accounts and Permissions</a></li>
@@ -233,15 +237,10 @@ limitations under the License.
 
 <p>The Apache Beam community welcomes contributions from anyone!</p>
 
-<p>If you have questions, consult the <a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">contribution FAQ</a>, and if that doesn’t
-help please <a href="/community/contact-us">reach out to the Beam community</a>.</p>
-
-<p>The Apache Beam SDK is a unified programming model for both batch and streaming data processing pipelines.
-Pipelines can be described in Java, Python, Go, or SQL, or in a DSL and be executed on
-different runners including Google Cloud Dataflow, Apache Flink, Apache Spark, Apache Apex,
-Apache Gearpump, Apache Hadoop MapReduce, JStorm, IBM Streams, or Apache Samza.</p>
+<p>If you have questions, please <a href="/contribute/get-help">reach out to the Beam community</a>.</p>
 
 <p>There are lots of opportunities to contribute:</p>
+
 <ul>
   <li>ask or answer questions on <a href="/community/contact-us/">user@beam.apache.org</a> or
 <a href="https://stackoverflow.com/questions/tagged/apache-beam">stackoverflow</a></li>
@@ -249,17 +248,16 @@ Apache Gearpump, Apache Hadoop MapReduce, JStorm, IBM Streams, or Apache Samza.<
   <li>improve the documentation</li>
   <li>contribute <a href="https://issues.apache.org/jira/projects/BEAM/issues">bug reports</a></li>
   <li>write new examples</li>
-  <li>add new user-facing libraries (new statistical libraries, new IO connectors,
-etc)</li>
   <li>improve your favorite language SDK (Java, Python, Go, etc)</li>
   <li>improve specific runners (Apache Apex, Apache Flink, Apache Spark, Google
 Cloud Dataflow, etc)</li>
   <li>improve or add IO connectors</li>
+  <li>add new transform libraries (statistics, ML, image processing, etc)</li>
   <li>work on the core programming model (what is a Beam pipeline and how does it
 run?)</li>
-  <li>improve the developer experience on Windows</li>
-  <li>adding answers to the <a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">contribution FAQ</a></li>
-  <li>organize local meetups of users or contributors to the Apache Beam SDK</li>
+  <li>improve the developer experience (for example, Windows guides)</li>
+  <li>add answers to the <a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">contribution FAQ</a></li>
+  <li>organize local meetups of users or contributors to Apache Beam</li>
 </ul>
 
 <p>Most importantly, if you have an idea of how to contribute, then do it!</p>
@@ -267,6 +265,7 @@ run?)</li>
 <h2 id="prerequisites-for-contributing-code">Prerequisites for contributing code</h2>
 
 <p>To contribute code, you need</p>
+
 <ul>
   <li>a GitHub account</li>
   <li>a Linux, macOS, or Microsoft Windows development environment with Java JDK 8 installed</li>
@@ -279,16 +278,29 @@ Agreement</a> (ICLA) to the Apache
 Software Foundation (ASF).</li>
 </ul>
 
-<h2 id="submitting-your-first-code-change">Submitting your first code change</h2>
+<h2 id="contributing-code">Contributing code</h2>
+
+<p>Below is a tutorial for contributing code to Beam, covering our tools and typical process in
+detail.</p>
+
+<h3 id="connect-with-the-beam-community">Connect With the Beam community</h3>
 
 <ol>
   <li>Consider subscribing to the <a href="/community/contact-us/">dev@ mailing list</a>, especially
 if you plan to make more than one change or the change will be large. All decisions happen on the
 public dev list.</li>
-  <li>Create an account on <a href="https://issues.apache.org/jira/projects/BEAM/issues">Beam issue tracker (JIRA)</a>.</li>
   <li>(Optionally) Join the <a href="/community/contact-us/">#beam channel of the ASF slack</a>.</li>
+  <li>Create an account on <a href="https://issues.apache.org/jira/projects/BEAM/issues">Beam issue tracker (JIRA)</a>
+(anyone can do this).</li>
+</ol>
+
+<h3 id="share-your-intent">Share your intent</h3>
+
+<ol>
   <li>Find or create an issue in the <a href="https://issues.apache.org/jira/projects/BEAM/issues">Beam issue tracker (JIRA)</a>.
-All changes should be tracked in an issue and referenced by the pull request. For a list of open starter tasks, check
+Tracking your work in an issue will avoid duplicated or conflicting work, and provide
+a place for notes. Later, your pull request will be linked to the issue as well.</li>
+  <li>If you want to get involved but don’t have a project in mind, check our list of open starter tasks,
 <a href="https://s.apache.org/beam-starter-tasks">https://s.apache.org/beam-starter-tasks</a>.</li>
   <li>Assign the issue to yourself. To get the permission to do so, email
 the <a href="/community/contact-us">dev@ mailing list</a>
@@ -298,10 +310,12 @@ ASF Jira Username. For example <a href="https://lists.apache.org/thread.html/e60
 <a href="/community/contact-us/">discuss it on the dev@ mailing list</a></li>
   <li>For large changes create a design doc
 (<a href="https://s.apache.org/beam-design-doc-template">template</a>,
-<a href="https://s.apache.org/beam-design-docs">examples</a>) and email it to the dev@ mailing list.
-Large contributions also require a signed <a href="https://www.apache.org/licenses/icla.pdf">Individual Contributor License
-Agreement</a> (ICLA) to the Apache
-Software Foundation (ASF).</li>
+<a href="https://s.apache.org/beam-design-docs">examples</a>) and email it to the dev@ mailing list.</li>
+</ol>
+
+<h3 id="development-setup">Development Setup</h3>
+
+<ol>
   <li>If you need help with git forking, cloning, branching, committing, pull requests, and squashing commits, see
 <a href="https://cwiki.apache.org/confluence/display/BEAM/Git+Tips">Git workflow tips</a></li>
   <li>
@@ -346,20 +360,27 @@ $ ./gradlew -p runners/flink check
 </code></pre>
     </div>
   </li>
-  <li>Depending on the area you are updating, review tips for
+  <li>Now you may want to set up your preferred IDE and other aspects of your development
+environment. See the Developers’ wiki for tips, guides, and FAQs on:
     <ul>
+      <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Using+IntelliJ+IDE">IntelliJ</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Java+Tips">Java</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Python+Tips">Python</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Go+Tips">Go</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Website+Tips">Website</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Gradle+Tips">Gradle</a></li>
       <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Jenkins+Tips">Jenkins</a></li>
+      <li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
     </ul>
   </li>
+</ol>
+
+<h3 id="make-your-change">Make your change</h3>
+
+<ol>
   <li>Make your code change. Every source file needs to include the Apache license header. Every new dependency needs to
 have an open source license <a href="https://www.apache.org/legal/resolved.html#criteria">compatible</a> with Apache.</li>
   <li>Add unit tests for your change</li>
-  <li>Ensure tests pass locally</li>
   <li>When your change is ready to be reviewed and merged, create a pull request.
 Format the pull request title like <code class="highlighter-rouge">[BEAM-XXX] Fixes bug in ApproximateQuantiles</code>,
 where you replace BEAM-XXX with the appropriate JIRA issue.
diff --git a/website/generated-content/contribute/postcommits-guides/index.html b/website/generated-content/contribute/postcommits-guides/index.html
index 787e73c..29a2ca4 100644
--- a/website/generated-content/contribute/postcommits-guides/index.html
+++ b/website/generated-content/contribute/postcommits-guides/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/postcommits-policies-details/index.html b/website/generated-content/contribute/postcommits-policies-details/index.html
index a164847..7aa629a 100644
--- a/website/generated-content/contribute/postcommits-policies-details/index.html
+++ b/website/generated-content/contribute/postcommits-policies-details/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/postcommits-policies/index.html b/website/generated-content/contribute/postcommits-policies/index.html
index 190d7eb..ac370e5 100644
--- a/website/generated-content/contribute/postcommits-policies/index.html
+++ b/website/generated-content/contribute/postcommits-policies/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/precommit-policies/index.html b/website/generated-content/contribute/precommit-policies/index.html
index 7040441..b6e0b80 100644
--- a/website/generated-content/contribute/precommit-policies/index.html
+++ b/website/generated-content/contribute/precommit-policies/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/precommit-triage-guide/index.html b/website/generated-content/contribute/precommit-triage-guide/index.html
index 04758be..86dbcf8 100644
--- a/website/generated-content/contribute/precommit-triage-guide/index.html
+++ b/website/generated-content/contribute/precommit-triage-guide/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/ptransform-style-guide/index.html b/website/generated-content/contribute/ptransform-style-guide/index.html
index 0582928..2ff0ed8 100644
--- a/website/generated-content/contribute/ptransform-style-guide/index.html
+++ b/website/generated-content/contribute/ptransform-style-guide/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/release-guide/index.html b/website/generated-content/contribute/release-guide/index.html
index 87fe5f9..0762262 100644
--- a/website/generated-content/contribute/release-guide/index.html
+++ b/website/generated-content/contribute/release-guide/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/runner-guide/index.html b/website/generated-content/contribute/runner-guide/index.html
index 259304d..3736660 100644
--- a/website/generated-content/contribute/runner-guide/index.html
+++ b/website/generated-content/contribute/runner-guide/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/contribute/testing/index.html b/website/generated-content/contribute/testing/index.html
index a153c13..a5484ab 100644
--- a/website/generated-content/contribute/testing/index.html
+++ b/website/generated-content/contribute/testing/index.html
@@ -147,12 +147,11 @@
 
 <li><span class="section-nav-list-main-title">Contribute</span></li>
 <li><a href="/contribute/">Get started contributing</a></li>
-<li><a href="https://cwiki.apache.org/confluence/display/BEAM/Development+Environment+FAQ">FAQ</a></li>
+<li><a href="/contribute/get-help/">Get Help</a></li>
 <li>
   <span class="section-nav-list-title">Technical Docs</span>
 
   <ul class="section-nav-list">
-    <li><a href="/roadmap/">Roadmap</a></li>
     <li><a href="/contribute/testing/">Testing guide</a></li>
     <li><a href="/contribute/precommit-triage-guide/">Pre-commit Slowness Triage</a></li>
     <li><a href="/contribute/ptransform-style-guide/">PTransform style guide</a></li>
@@ -173,13 +172,11 @@
 <li>
   <span class="section-nav-list-title">Committers</span>
   <ul class="section-nav-list">
-    <li><a href="/contribute/team/">PMC and committers</a></li>
     <li><a href="/contribute/become-a-committer/">Become a committer</a></li>
     <li><a href="/contribute/committer-guide/">Committer guide</a></li>
     <li><a href="/contribute/release-guide/">Release guide</a></li>
   </ul>
 </li>
-<li><a href="/community/contact-us/">Contact Us</a></li>
 
           </ul>
         </nav>
diff --git a/website/generated-content/get-started/beam-overview/index.html b/website/generated-content/get-started/beam-overview/index.html
index 62762b3..4f95f85 100644
--- a/website/generated-content/get-started/beam-overview/index.html
+++ b/website/generated-content/get-started/beam-overview/index.html
@@ -265,7 +265,7 @@ limitations under the License.
 
 <h2 id="contribute">Contribute</h2>
 
-<p>Beam is an <a href="http://www.apache.org">Apache Software Foundation</a> project, available under the Apache v2 license. Beam is an open source community and contributions are greatly appreciated! If you’d like to contribute, please see the <a href="/contribute/">Contribute</a> section.</p>
+<p>Beam is an <a href="http://www.apache.org" target="_blank">Apache Software Foundation</a> project, available under the Apache v2 license. Beam is an open source community and contributions are greatly appreciated! If you’d like to contribute, please see the <a href="/contribute/">Contribute</a> section.</p>
 
       </div>
     </div>


Mime
View raw message