Make documentation/io/connectors/ canonical (#23877)

* Drop documentation/io/built-in/ * Update links in Custom I/O pattern
apache · Nov 7, 2022 · 98d2ffd · 98d2ffd
1 parent c0b41fa
commit 98d2ffd
Show file tree

Hide file tree

Showing 6 changed files with 9 additions and 584 deletions.
diff --git a/website/www/site/content/en/documentation/io/built-in.md b/website/www/site/content/en/documentation/io/built-in.md
diff --git a/website/www/site/content/en/documentation/io/connectors.md b/website/www/site/content/en/documentation/io/connectors.md
@@ -1,5 +1,6 @@
 ---
 title: "I/O Connectors"
+aliases: [built-in]
 ---
 <!--
 Licensed under the Apache License, Version 2.0 (the "License");
@@ -133,7 +134,7 @@ This table provides a consolidated, at-a-glance overview of the available built-
     <td class="present">✔</td>
   </tr>
   <tr>
-    <td>ParquetIO</td>
+    <td>ParquetIO (<a href="/documentation/io/built-in/parquet/">guide</a>)</td>
     <td class="present">✔</td>
     <td class="present">✔</td>
     <td class="present">
@@ -390,7 +391,7 @@ This table provides a consolidated, at-a-glance overview of the available built-
     <td class="absent">✘</td>
   </tr>
   <tr>
-    <td>HadoopFormatIO</td>
+    <td>HadoopFormatIO (<a href="/documentation/io/built-in/hadoop/">guide</a>)</td>
     <td class="present">✔</td>
     <td class="present">✔</td>
     <td class="present">
@@ -416,7 +417,7 @@ This table provides a consolidated, at-a-glance overview of the available built-
     <td class="absent">✘</td>
   </tr>
   <tr>
-    <td>HCatalogIO</td>
+    <td>HCatalogIO (<a href="/documentation/io/built-in/hcatalog/">guide</a>)</td>
     <td class="present">✔</td>
     <td class="present">✔</td>
     <td class="present">
@@ -468,7 +469,7 @@ This table provides a consolidated, at-a-glance overview of the available built-
     <td class="present">✔</td>
   </tr>
   <tr>
-    <td>BigQueryIO</td>
+    <td>BigQueryIO (<a href="/documentation/io/built-in/google-bigquery/">guide</a>)</td>
     <td class="present">✔</td>
     <td class="present">✔</td>
     <td class="present">
@@ -522,7 +523,7 @@ This table provides a consolidated, at-a-glance overview of the available built-
     <td class="present">✔</td>
   </tr>
   <tr>
-    <td>SnowflakeIO</td>
+    <td>SnowflakeIO (<a href="/documentation/io/built-in/snowflake">guide</a>)</td>
     <td class="present">✔</td>
     <td class="present">✔</td>
     <td class="present">

diff --git a/website/www/site/content/en/documentation/patterns/custom-io.md b/website/www/site/content/en/documentation/patterns/custom-io.md
@@ -17,13 +17,13 @@ limitations under the License.
 
 # Custom I/O patterns
 
-This page describes common patterns in pipelines with [custom I/O connectors](/documentation/io/developing-io-overview/). Custom I/O connectors connect pipelines to databases that aren't supported by Beam's [built-in I/O transforms](/documentation/io/built-in/).
+This page describes common patterns in pipelines with [custom I/O connectors](/documentation/io/developing-io-overview/). Custom I/O connectors connect pipelines to databases that aren't supported by Beam's [built-in I/O transforms](/documentation/io/connectors/).
 
 {{< language-switcher java py >}}
 
 ## Choosing between built-in and custom connectors
 
-[Built-in I/O connectors](/documentation/io/built-in/) are tested and hardened, so use them whenever possible. Only use custom I/O connectors when:
+[Built-in I/O connectors](/documentation/io/connectors/) are tested and hardened, so use them whenever possible. Only use custom I/O connectors when:
 
 * No built-in options exist
 * Your pipeline pulls in a small subset of source data