From 152d04fe6e5873443fd1ae8fdb84554684784c58 Mon Sep 17 00:00:00 2001
From: David Huntsperger <dhuntsperger@google.com>
Date: Thu, 13 Jan 2022 14:13:39 +0000
Subject: [PATCH 1/4] redirected xlang content

---
 .../site/content/en/documentation/programming-guide.md   | 1 +
 .../java-multi-language-pipelines.md}                    | 9 +++++----
 .../layouts/partials/section-menu/en/documentation.html  | 1 -
 .../www/site/layouts/partials/section-menu/en/sdks.html  | 1 +
 4 files changed, 7 insertions(+), 5 deletions(-)
 rename website/www/site/content/en/documentation/{patterns/cross-language.md => sdks/java-multi-language-pipelines.md} (95%)

diff --git a/website/www/site/content/en/documentation/programming-guide.md b/website/www/site/content/en/documentation/programming-guide.md
index 5cb9aab83bf5..306c766e3dc1 100644
--- a/website/www/site/content/en/documentation/programming-guide.md
+++ b/website/www/site/content/en/documentation/programming-guide.md
@@ -3,6 +3,7 @@ title: "Beam Programming Guide"
 aliases:
   - /learn/programming-guide/
   - /docs/learn/programming-guide/
+  - /documentation/patterns/cross-language/
 ---
 <!--
 Licensed under the Apache License, Version 2.0 (the "License");
diff --git a/website/www/site/content/en/documentation/patterns/cross-language.md b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
similarity index 95%
rename from website/www/site/content/en/documentation/patterns/cross-language.md
rename to website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
index 37585089e8db..ad750040d145 100644
--- a/website/www/site/content/en/documentation/patterns/cross-language.md
+++ b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
@@ -1,5 +1,6 @@
 ---
-title: "Cross-language transforms"
+type: languages
+title: "Java multi-language pipelines quickstart"
 ---
 
 <!--
@@ -14,11 +15,11 @@ See the License for the specific language governing permissions and
 limitations under the License.
 -->
 
-# Cross-language transforms
+# Java multi-language pipelines quickstart
 
-With the samples on this page we will demonstrate how to create and leverage cross-language pipelines.
+> **Note:** This page is a work in progress. Please see [Multi-language pipelines](https://beam.apache.org/documentation/programming-guide/#multi-language-pipelines) for full documentation.
 
-> **Note:** Please see the [Beam Programming Guide](https://beam.apache.org/documentation/programming-guide/#multi-language-pipelines) for full documentation on cross-language transforms.
+With the samples on this page we will demonstrate how to create and leverage cross-language pipelines.
 
 The goal of a cross-language pipeline is to incorporate transforms from one SDK (e.g. the Python SDK) into a pipeline written using another SDK (e.g. the Java SDK). This enables having already developed transforms (e.g. ML transforms in Python) and libraries (e.g. the vast library of IOs in Java), and strengths of certain languages at your disposal in whichever language you are more comfortable authoring pipelines while vastly expanding your toolkit in given language.
 
diff --git a/website/www/site/layouts/partials/section-menu/en/documentation.html b/website/www/site/layouts/partials/section-menu/en/documentation.html
index 3f09b0e19d70..b144c7f20cae 100644
--- a/website/www/site/layouts/partials/section-menu/en/documentation.html
+++ b/website/www/site/layouts/partials/section-menu/en/documentation.html
@@ -205,7 +205,6 @@
     <li><a href="/documentation/patterns/ai-platform/">AI Platform</a></li>
     <li><a href="/documentation/patterns/schema/">Schema</a></li>
     <li><a href="/documentation/patterns/bqml/">BigQuery ML</a></li>
-    <li><a href="/documentation/patterns/cross-language/">Cross-language transforms</a></li>
     <li><a href="/documentation/patterns/grouping-elements-for-efficient-external-service-calls/">Grouping elements for efficient external service calls</a></li>
   </ul>
 </li>
diff --git a/website/www/site/layouts/partials/section-menu/en/sdks.html b/website/www/site/layouts/partials/section-menu/en/sdks.html
index 52419e8a2acc..ef0b2bbdaaf4 100644
--- a/website/www/site/layouts/partials/section-menu/en/sdks.html
+++ b/website/www/site/layouts/partials/section-menu/en/sdks.html
@@ -24,6 +24,7 @@
     <li><a href="/documentation/sdks/java-extensions/">Java SDK extensions</a></li>
     <li><a href="/documentation/sdks/java-thirdparty/">Java 3rd party extensions</a></li>
     <li><a href="/documentation/sdks/java/testing/nexmark/">Nexmark benchmark suite</a></li>
+    <li><a href="/documentation/sdks/java-multi-language-pipelines/">Java multi-language pipelines quickstart</a></li>
   </ul>
 </li>
 

From 760fd0375de28adb926fb7c441a490a6423fa530 Mon Sep 17 00:00:00 2001
From: David Huntsperger <dhuntsperger@google.com>
Date: Thu, 13 Jan 2022 14:37:50 +0000
Subject: [PATCH 2/4] updated redirect and added blurb for Java multi-lang
 quickstart

---
 .../en/documentation/sdks/java-multi-language-pipelines.md    | 2 ++
 website/www/site/content/en/documentation/sdks/java.md        | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
index ad750040d145..b6b86163dc7e 100644
--- a/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
+++ b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
@@ -1,6 +1,8 @@
 ---
 type: languages
 title: "Java multi-language pipelines quickstart"
+aliases:
+  - /documentation/patterns/cross-language/
 ---
 
 <!--
diff --git a/website/www/site/content/en/documentation/sdks/java.md b/website/www/site/content/en/documentation/sdks/java.md
index 0382ec56fc4d..71d6385ac088 100644
--- a/website/www/site/content/en/documentation/sdks/java.md
+++ b/website/www/site/content/en/documentation/sdks/java.md
@@ -47,3 +47,7 @@ The Java SDK has the following extensions:
 - [euphoria](/documentation/sdks/java/euphoria) is easy to use Java 8 DSL for BEAM.
 
 In addition several [3rd party Java libraries](/documentation/sdks/java-thirdparty/) exist.
+
+## Java multi-language pipelines quickstart
+
+Apache Beam lets you combine transforms written in any supported SDK language and use them in one multi-language pipeline. To learn how to create a multi-language pipeline using the Java SDK, see the [Java multi-language pipelines quickstart](/documentation/sdks/java-multi-language-pipelines).

From 4c6554f84f43adad91eee27ab4e7e8147a2d3995 Mon Sep 17 00:00:00 2001
From: David Huntsperger <dhuntsperger@google.com>
Date: Thu, 13 Jan 2022 15:14:32 +0000
Subject: [PATCH 3/4] removing unnecessary alias from programming guide

---
 website/www/site/content/en/documentation/programming-guide.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/website/www/site/content/en/documentation/programming-guide.md b/website/www/site/content/en/documentation/programming-guide.md
index 306c766e3dc1..5cb9aab83bf5 100644
--- a/website/www/site/content/en/documentation/programming-guide.md
+++ b/website/www/site/content/en/documentation/programming-guide.md
@@ -3,7 +3,6 @@ title: "Beam Programming Guide"
 aliases:
   - /learn/programming-guide/
   - /docs/learn/programming-guide/
-  - /documentation/patterns/cross-language/
 ---
 <!--
 Licensed under the Apache License, Version 2.0 (the "License");

From 586b753e8370b0e69d72b711f656e53df9628f59 Mon Sep 17 00:00:00 2001
From: David Huntsperger <dhuntsperger@google.com>
Date: Fri, 14 Jan 2022 17:59:53 +0000
Subject: [PATCH 4/4] improved opening sentence of Java multi-language
 pipelines page

---
 .../en/documentation/sdks/java-multi-language-pipelines.md      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
index b6b86163dc7e..33bd11a47873 100644
--- a/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
+++ b/website/www/site/content/en/documentation/sdks/java-multi-language-pipelines.md
@@ -21,7 +21,7 @@ limitations under the License.
 
 > **Note:** This page is a work in progress. Please see [Multi-language pipelines](https://beam.apache.org/documentation/programming-guide/#multi-language-pipelines) for full documentation.
 
-With the samples on this page we will demonstrate how to create and leverage cross-language pipelines.
+This page demonstrates how to write a Java pipeline that uses a Python cross-language transform.
 
 The goal of a cross-language pipeline is to incorporate transforms from one SDK (e.g. the Python SDK) into a pipeline written using another SDK (e.g. the Java SDK). This enables having already developed transforms (e.g. ML transforms in Python) and libraries (e.g. the vast library of IOs in Java), and strengths of certain languages at your disposal in whichever language you are more comfortable authoring pipelines while vastly expanding your toolkit in given language.