From 1a8e6f5d7befd1110ab4e3383481ba8908453b62 Mon Sep 17 00:00:00 2001
From: Brian Hulette <bhulette@google.com>
Date: Thu, 27 Oct 2022 15:50:33 -0700
Subject: [PATCH 1/2] Drop documentation/io/built-in/

---
 .../content/en/documentation/io/built-in.md   |  60 ---
 .../content/en/documentation/io/connectors.md |  11 +-
 website/www/site/data/io_matrix.yaml          | 460 ------------------
 .../section-menu/en/documentation.html        |   3 +-
 .../site/layouts/shortcodes/io-matrix.html    |  55 ---
 5 files changed, 7 insertions(+), 582 deletions(-)
 delete mode 100644 website/www/site/content/en/documentation/io/built-in.md
 delete mode 100644 website/www/site/data/io_matrix.yaml
 delete mode 100644 website/www/site/layouts/shortcodes/io-matrix.html

diff --git a/website/www/site/content/en/documentation/io/built-in.md b/website/www/site/content/en/documentation/io/built-in.md
deleted file mode 100644
index 5a250d4ab238..000000000000
--- a/website/www/site/content/en/documentation/io/built-in.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-title: "Built-in I/O Transforms"
----
-<!--
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-
-# Built-in I/O Transforms
-
-This table contains the currently available I/O transforms.
-
-Consult the [Programming Guide I/O section](/documentation/programming-guide#pipeline-io) for general usage instructions.
-
-{{< language-switcher java py go typescript >}}
-
-{{< io-matrix >}}
-
-# In-Progress I/O Transforms
-
-This table contains I/O transforms that are currently planned or in-progress. Status information can be found on the GitHub Issue issue, or on the GitHub PR linked to by the GitHub Issue issue (if there is one).
-
-<table class="table table-bordered">
-  <tr>
-    <th>Name</th><th>Language</th><th>Issue</th>
-  </tr>
-  <tr>
-    <td>Apache DistributedLog</td><td>Java</td>
-    <td><a href="https://github.com/apache/beam/issues/18026">Issue 18026</a></td>
-  </tr>
-  <tr>
-    <td>Apache Sqoop</td><td>Java</td>
-    <td><a href="https://github.com/apache/beam/issues/17958">Issue 17958</a></td>
-  </tr>
-  <tr>
-    <td>Couchbase</td><td>Java</td>
-    <td><a href="https://github.com/apache/beam/issues/18381">Issue 18381</a></td>
-  </tr>
-  <tr>
-    <td>Memcached</td><td>Java</td>
-    <td><a href="https://github.com/apache/beam/issues/21768">Issue 21768</a></td>
-  </tr>
-  <tr>
-    <td>RestIO</td><td>Java</td>
-    <td><a href="https://github.com/apache/beam/issues/18356">Issue 18356</a></td>
-  </tr>
-  <tr>
-    <td>NATS IO</td><td></td>
-    <td></td>
-  </tr>
-</table>
diff --git a/website/www/site/content/en/documentation/io/connectors.md b/website/www/site/content/en/documentation/io/connectors.md
index c2a2e78e34dc..1a922ae4715c 100644
--- 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/data/io_matrix.yaml b/website/www/site/data/io_matrix.yaml
deleted file mode 100644
index 46a4c6643fae..000000000000
--- a/website/www/site/data/io_matrix.yaml
+++ /dev/null
@@ -1,460 +0,0 @@
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-categories:
-  - name: File-based
-    description: These I/O connectors involve working with files.
-    rows:
-      - transform: FileIO
-        description: "General-purpose transforms for working with files: listing files (matching), reading and writing."
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.FileIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/FileIO.html
-          - language: py
-            name: apache_beam.io.FileIO
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.fileio.html
-      - transform: AvroIO
-        description: PTransforms for reading from and writing to [Avro](https://avro.apache.org/) files.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.AvroIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/AvroIO.html
-          - language: py
-            name: apache_beam.io.avroio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.avroio.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/avroio
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/avroio
-          - language: typescript
-            name: apache_beam.io.avroio.{readFrom,writeTo}Avro
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/avroio.ts
-      - transform: TextIO
-        description: PTransforms for reading and writing text files.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.TextIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/TextIO.html
-          - language: py
-            name: apache_beam.io.textio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.textio.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/textio
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/textio
-          - language: typescript
-            name: apache_beam.io.textio.{readFrom,writeTo}Text
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/textio.ts
-      - transform: CsvIO
-        description: PTransforms for reading and writing csv files.
-        implementations:
-          - language: typescript
-            name: apache_beam.io.textio.{readFrom,writeTo}Csv
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/textio.ts
-      - transform: JsonIO
-        description: PTransforms for reading and writing json line files.
-        implementations:
-          - language: typescript
-            name: apache_beam.io.textio.{readFrom,writeTo}Json
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/textio.ts
-      - transform: TFRecordIO
-        description: PTransforms for reading and writing [TensorFlow TFRecord](https://www.tensorflow.org/tutorials/load_data/tfrecord) files.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.TFRecordIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/TFRecordIO.html
-          - language: py
-            name: apache_beam.io.tfrecordio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.tfrecordio.html
-      - transform: XmlIO
-        description: Transforms for reading and writing XML files using [JAXB](https://www.oracle.com/technical-resources/articles/javase/jaxb.html) mappers.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.xml.XmlIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/xml/XmlIO.html
-      - transform: TikaIO
-        description: Transforms for parsing arbitrary files using [Apache Tika](https://tika.apache.org/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.tika.TikaIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/tika/TikaIO.html
-      - transform: ParquetIO
-        description: IO for reading from and writing to [Parquet](https://parquet.apache.org/) files.
-        docs: /documentation/io/built-in/parquet/
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.parquet.ParquetIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/parquet/ParquetIO.html
-          - language: py
-            name: apache_beam.io.parquetio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.parquetio.html
-          - language: typescript
-            name: apache_beam.io.parquetio
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/parquetio.ts
-      - transform: ThriftIO
-        description: PTransforms for reading and writing files containing [Thrift](https://thrift.apache.org/)-encoded data.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.thrift.ThriftIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/thrift/ThriftIO.html
-      - transform: S3IO
-        description: A source for reading from and writing to [Amazon S3](https://aws.amazon.com/s3/).
-        implementations:
-          - language: py
-            name: apache_beam.io.aws.s3io
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.aws.s3io.html
-      - transform: GcsIO
-        description: A source for reading from and writing to [Google Cloud Storage](https://cloud.google.com/storage).
-        implementations:
-          - language: py
-            name: apache_beam.io.gcp.gcsio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.gcsio.html
-  - name: FileSystem
-    description: Beam provides a File system interface that defines APIs for writing file systems agnostic code. Several I/O connectors are implemented as a FileSystem implementation.
-    rows:
-      - transform: HadoopFileSystem
-        description: "`FileSystem` implementation for accessing [Hadoop](https://hadoop.apache.org/) Distributed File System files."
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.hdfs.HadoopFileSystemRegistrar
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/hdfs/HadoopFileSystemRegistrar.html
-          - language: py
-            name: apache_beam.io.hadoopfilesystem
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.hadoopfilesystem.html
-          - language: typescript
-            name: cross language
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.hadoopfilesystem.html
-      - transform: GcsFileSystem
-        description: "`FileSystem` implementation for [Google Cloud Storage](https://cloud.google.com/storage)."
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.extensions.gcp.storage.GcsFileSystemRegistrar
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/extensions/gcp/storage/GcsFileSystemRegistrar.html
-          - language: py
-            name: apache_beam.io.gcp.gcsfilesystem
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.gcsfilesystem.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/filesystem/gcs
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/filesystem/gcs
-          - language: typescript
-            name: cross langauge
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/extensions/gcp/storage/GcsFileSystemRegistrar.html
-      - transform: LocalFileSystem
-        description: "`FileSystem` implementation for accessing files on disk."
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.LocalFileSystemRegistrar
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/LocalFileSystemRegistrar.html
-          - language: py
-            name: apache_beam.io.localfilesystem
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.localfilesystem.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/filesystem/local
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/filesystem/local
-      - transform: S3FileSystem
-        description: "`FileSystem` implementation for [Amazon S3](https://aws.amazon.com/s3/)."
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.aws2.s3.S3FileSystemRegistrar
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/aws2/s3/S3FileSystemRegistrar.html
-      - transform: In-memory
-        description: "`FileSystem` implementation in memory; useful for testing."
-        implementations:
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/filesystem/memfs
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/filesystem/memfs
-  - name: Messaging
-    description: These I/O connectors typically involve working with unbounded sources that come from messaging sources.
-    rows:
-      - transform: KinesisIO
-        description: PTransforms for reading from and writing to [Kinesis](https://aws.amazon.com/kinesis/) streams.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.aws2.kinesis.KinesisIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/aws2/kinesis/KinesisIO.html
-      - transform: AmqpIO
-        description: AMQP 1.0 protocol using the Apache QPid Proton-J library
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.amqp.AmqpIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/amqp/AmqpIO.html
-      - transform: KafkaIO
-        description: Read and Write PTransforms for [Apache Kafka](https://kafka.apache.org/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.kafka.KafkaIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/kafka/KafkaIO.html
-          - language: py
-            name: apache_beam.io.kafka
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.kafka.html
-          - language: typescript
-            name: apache_beam.io.kafka
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/kafka.ts
-      - transform: PubSubIO
-        description: Read and Write PTransforms for [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) streams.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.pubsub.PubsubIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/pubsub/PubsubIO.html
-          - language: py
-            name: apache_beam.io.gcp.pubsub
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.pubsub.html
-          - language: py
-            name: apache_beam.io.external.gcp.pubsub
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.external.gcp.pubsub.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/pubsubio
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/pubsubio
-          - language: typescript
-            name: apache_beam.io.pubsub
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/pubsub.ts
-      - transform: JmsIO
-        description: An unbounded source for [JMS](https://www.oracle.com/java/technologies/java-message-service.html) destinations (queues or topics).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.jms.JmsIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/jms/JmsIO.html
-      - transform: MqttIO
-        description: An unbounded source for [MQTT](https://mqtt.org/) broker.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.mqtt.MqttIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/mqtt/MqttIO.html
-      - transform: RabbitMqIO
-        description: A IO to publish or consume messages with a RabbitMQ broker.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.rabbitmq.RabbitMqIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/rabbitmq/RabbitMqIO.html
-      - transform: SqsIO
-        description: An unbounded source for [Amazon Simple Queue Service (SQS)](https://aws.amazon.com/sqs/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.aws2.sqs.SqsIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/aws2/sqs/SqsIO.html
-      - transform: SnsIO
-        description: PTransforms for writing to [Amazon Simple Notification Service (SNS)](https://aws.amazon.com/sns/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.aws2.sns.SnsIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/aws2/sns/SnsIO.html
-      - transform: Pub/Sub Lite
-        description: I/O transforms for reading from Google Pub/Sub Lite.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.pubsublite.PubSubLiteIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/pubsublite/PubsubLiteIO.html
-          - language: typescript
-            name: apache_beam.io.pubsublite
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/pubsublite.ts
-  - name: Database
-    description: These I/O connectors are used to connect to database systems.
-    rows:
-      - transform: CassandraIO
-        description: An IO to read from [Apache Cassandra](https://cassandra.apache.org/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.cassandra.CassandraIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/cassandra/CassandraIO.html
-      - transform: HadoopFormatIO
-        description: Allows for reading data from any source or writing data to any sink which implements [Hadoop](https://hadoop.apache.org/) InputFormat or OutputFormat.
-        docs: /documentation/io/built-in/hadoop/
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.hadoop.format.HadoopFormatIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/hadoop/format/HadoopFormatIO.html
-      - transform: HBaseIO
-        description: A bounded source and sink for [HBase](https://hbase.apache.org/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.hbase.HBaseIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/hbase/HBaseIO.html
-      - transform: HCatalogIO
-        description: HCatalog source supports reading of HCatRecord from a [HCatalog](https://cwiki.apache.org/confluence/display/Hive/HCatalog)-managed source, for example [Hive](https://hive.apache.org/).
-        docs: /documentation/io/built-in/hcatalog/
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.hcatalog.HCatalogIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/hcatalog/HCatalogIO.html
-      - transform: KuduIO
-        description: A bounded source and sink for [Kudu](https://kudu.apache.org/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.kudu
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/kudu/KuduIO.html
-      - transform: SolrIO
-        description: Transforms for reading and writing data from/to [Solr](https://lucene.apache.org/solr/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.solr.SolrIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/solr/SolrIO.html
-      - transform: ElasticsearchIO
-        description: Transforms for reading and writing data from/to [Elasticsearch](https://www.elastic.co/elasticsearch/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.elasticsearch.ElasticsearchIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/elasticsearch/ElasticsearchIO.html
-      - transform: BigQueryIO
-        description: Read from and write to [Google Cloud BigQuery](https://cloud.google.com/bigquery).
-        docs: /documentation/io/built-in/google-bigquery/
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.bigquery.BigQueryIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.html
-          - language: py
-            name: apache_beam.io.gcp.bigquery
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.bigquery.html
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/bigqueryio
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/bigqueryio
-          - language: typescript
-            name: apache_beam.io.bigqueryio
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/bigqueryio.ts
-      - transform: BigTableIO
-        description: Read from (only for Java SDK) and write to [Google Cloud Bigtable](https://cloud.google.com/bigtable/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.bigtable.BigtableIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/bigtable/BigtableIO.html
-          - language: py
-            name: apache_beam.io.gcp.bigtableio module
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.bigtableio.html
-      - transform: DatastoreIO
-        description: Read from and write to [Google Cloud Datastore](https://cloud.google.com/datastore).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.datastore.DatastoreIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/datastore/DatastoreIO.html
-          - language: py
-            name: apache_beam.io.gcp.datastore.v1new.datastoreio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.gcp.datastore.v1new.datastoreio.html
-      - transform: SnowflakeIO
-        description: Experimental Transforms for reading from and writing to [Snowflake](https://www.snowflake.com/).
-        docs: /documentation/io/built-in/snowflake
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.snowflake.SnowflakeIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/snowflake/SnowflakeIO.html
-          - language: py
-            name: apache_beam.io.snowflake
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.snowflake.html
-      - transform: SpannerIO
-        description: Experimental Transforms for reading from and writing to [Google Cloud Spanner](https://cloud.google.com/spanner).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.spanner.SpannerIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/spanner/SpannerIO.html
-      - transform: JdbcIO
-        description: IO to read and write data on [JDBC](https://docs.oracle.com/javase/tutorial/jdbc/basics/index.html).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.jdbc.JdbcIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/jdbc/JdbcIO.html
-      - transform: MongoDbIO
-        description: IO to read and write data on [MongoDB](https://www.mongodb.com/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.mongodb.MongoDbIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/mongodb/MongoDbIO.html
-          - language: py
-            name: apache_beam.io.mongodbio
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.mongodbio.html
-      - transform: MongoDbGridFSIO
-        description: IO to read and write data on [MongoDB GridFS](https://docs.mongodb.com/manual/core/gridfs/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.mongodb.MongoDbGridFSIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/mongodb/MongoDbGridFSIO.html
-      - transform: RedisIO
-        description: An IO to manipulate a [Redis](https://redis.io/) key/value database.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.redis.RedisIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/redis/RedisIO.html
-      - transform: DynamoDBIO
-        description: Read from and write to [Amazon DynamoDB](https://aws.amazon.com/dynamodb/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.aws2.dynamodb.DynamoDBIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/aws2/dynamodb/DynamoDBIO.html
-      - transform: ClickHouseIO
-        description: Transform for writing to [ClickHouse](https://clickhouse.tech/).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.clickhouse.ClickHouseIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/clickhouse/ClickHouseIO.html
-      - transform: DatabaseIO
-        description: Package databaseio provides transformations and utilities to interact with a generic database / SQL API.
-        implementations:
-          - language: go
-            name: github.com/apache/beam/sdks/go/pkg/beam/io/databaseio
-            url: https://pkg.go.dev/github.com/apache/beam/sdks/v2/go/pkg/beam/io/databaseio
-      - transform: InfluxDB
-        description: IO to read and write from InfluxDB.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.influxdb.InfluxDbIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/influxdb/InfluxDbIO.html
-      - transform: Firestore IO
-        description: FirestoreIO provides an API for reading from and writing to Google Cloud Firestore.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.healthcare.FirestoreIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/firestore/FirestoreIO.html
-      - transform: Neo4j
-        implementations:
-          - language: java
-  - name: Miscellaneous
-    description: Miscellaneous I/O sources.
-    rows:
-      - transform: FlinkStreamingImpulseSource
-        description: A PTransform that provides an unbounded, streaming source of empty byte arrays. This can only be used with the Flink runner.
-        implementations:
-          - language: py
-            name: apache_beam.io.flink.flink_streaming_impulse_source
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.flink.flink_streaming_impulse_source.html
-      - transform: GenerateSequence
-        description: Generates a bounded or unbounded stream of integers.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.GenerateSequence
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/GenerateSequence.html
-          - language: py
-            name: apache_beam.io.external.generate_sequence.GenerateSequence
-            url: https://beam.apache.org/releases/pydoc/current/apache_beam.io.external.generate_sequence.html
-      - transform: SplunkIO
-        description: A PTransform that provides an unbounded, streaming sink for Splunk's Http Event Collector (HEC).
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.splunk.SplunkIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/splunk/SplunkIO.html
-      - transform: FhirIO
-        description: Provides an API for reading and writing resources to Google Cloud Healthcare Fhir API.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.healthcare.FhirIO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/healthcare/FhirIO.html
-      - transform: HL7v2IO
-        description: Provides an API for reading from and writing to Google Cloud Healthcare HL7v2 API.
-        implementations:
-          - language: java
-            name: org.apache.beam.sdk.io.gcp.healthcare.HL7v2IO
-            url: https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/gcp/healthcare/HL7v2IO.html
-      - transform: Cross-language Schema IO
-        description: Many IOs from other langauges can be easily accessed as
-            [cross-language transforms](/documentation/programming-guide/#use-x-lang-transforms).
-        implementations:
-          - language: typescript
-            name: apache_beam.io.schemaio
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/io/schemaio.ts
-          - language: typescript
-            name: apache_beam.transforms.python
-            url: https://github.com/apache/beam/blob/master/sdks/typescript/src/apache_beam/transforms/python.ts
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 345ab8bc8195..a676fd95cd1d 100644
--- a/website/www/site/layouts/partials/section-menu/en/documentation.html
+++ b/website/www/site/layouts/partials/section-menu/en/documentation.html
@@ -63,11 +63,10 @@
 
       <ul class="section-nav-list">
         <li><a href="/documentation/programming-guide/#pipeline-io">Using I/O transforms</a></li>
-        <li><a href="/documentation/io/built-in/">Built-in I/O connectors</a></li>
         <li><a href="/documentation/io/connectors/">I/O connectors</a></li>
 
         <li class="section-nav-item--collapsible">
-          <span class="section-nav-list-title">Built-in I/O connector guides</span>
+          <span class="section-nav-list-title">I/O connector guides</span>
           <ul class="section-nav-list">
             <li><a href="/documentation/io/built-in/parquet/">Apache Parquet I/O connector
             </a></li>
diff --git a/website/www/site/layouts/shortcodes/io-matrix.html b/website/www/site/layouts/shortcodes/io-matrix.html
deleted file mode 100644
index 3fd1eef025ac..000000000000
--- a/website/www/site/layouts/shortcodes/io-matrix.html
+++ /dev/null
@@ -1,55 +0,0 @@
-{{/*
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-    http://www.apache.org/licenses/LICENSE-2.0
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License. See accompanying LICENSE file.
- */}}
- 
-{{ $data := index $.Site.Data.io_matrix }}
-
-{{ define "language-row" }}
-  {{ if len (where .row.implementations "language" .language) }}
-  <tr class="language-{{ .language }}">
-    <td>
-      {{ .row.transform | markdownify }}
-      {{ if .row.docs }}<a href="{{ .row.docs }}"> (guide)</a>{{ else }}{{ end }}
-    </td>
-    <td>{{ .row.description | markdownify }}</td>
-    <td style="word-break: break-all;">
-      {{ range where .row.implementations "language" .language }}
-        <div><a target="_blank" href="{{ .url }}">{{ .name }}</a></div>
-      {{ else }}
-        N/A
-      {{ end }}
-    </td>
-  </tr>
-  {{ else }}
-  {{ end }}
-{{ end }}
-
-
-{{ range $data.categories }}
-<h3>{{ .name }}</h3>
-<p>{{ .description }}</p>
-<table class="table table-bordered">
-  <tr>
-    <th>Name</th>
-    <th>Description</th>
-    <th>
-      <span class="language-java">Javadoc</span>
-      <span class="language-py">pydoc</span>
-      <span class="language-go">Godoc</span>
-    </th>
-  </tr>
-  {{ range .rows }}
-    {{ block "language-row" (dict "row" . "language" "java") }}{{ end }}
-    {{ block "language-row" (dict "row" . "language" "py") }}{{ end }}
-    {{ block "language-row" (dict "row" . "language" "go") }}{{ end }}
-  {{ end }}
-</table>
-{{ end }}
\ No newline at end of file

From c62f7dc095b3565753d0c191e5ec590b2ff51fb0 Mon Sep 17 00:00:00 2001
From: Brian Hulette <bhulette@google.com>
Date: Thu, 27 Oct 2022 16:33:18 -0700
Subject: [PATCH 2/2] Update links in Custom I/O pattern

---
 .../www/site/content/en/documentation/patterns/custom-io.md   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/www/site/content/en/documentation/patterns/custom-io.md b/website/www/site/content/en/documentation/patterns/custom-io.md
index 9e3e7fbd57ca..29242334aec6 100644
--- 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