crate · amotl · Aug 2, 2023 · Aug 1, 2023
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -9,4 +9,6 @@ Unreleased
 - Consolidate ``cloud-reference``, ``cloud-howtos``, and ``cloud-tutorials``
 - Adjust links to accompany renaming to ``cloud-docs``
 - Adjust intersphinx references to accompany consolidation into single repository
-- Rename top-level directories to `howtos`, `reference`, and `tutorials`
+- Rename top-level directories to `howtos`, `reference`, and `tutorials`
+- Refactored content about connectivity concerns to dedicated section at
+  ``crate-client-tools``
diff --git a/docs/howtos/connect-to-cluster/cli.rst b/docs/howtos/connect-to-cluster/cli.rst
diff --git a/docs/howtos/connect-to-cluster/index.md b/docs/howtos/connect-to-cluster/index.md
@@ -0,0 +1,23 @@
+(connect-to-cluster-howto-index)=
+# Connect to your cluster
+
+We are maintaining a collection of how-to guides and tutorials about how to
+integrate with different applications, tools, libraries, extensions, and clients,
+that can be used to connect to your CrateDB Cloud cluster.
+
+
+::::{grid} 1 2 2 2
+:margin: 4 4 0 0
+:gutter: 1
+
+
+:::{grid-item-card} {material-outlined}`link;2em` Clients, Tools, and Integrations
+:link: crate-clients-tools:index
+:link-type: ref
+
+Learn about compatible client applications and tools, and how to configure
+your favorite client library to connect to a CrateDB cluster.
+:::
+
+
+::::
diff --git a/docs/howtos/connect-to-cluster/index.rst b/docs/howtos/connect-to-cluster/index.rst
diff --git a/docs/howtos/connect-to-cluster/java.rst b/docs/howtos/connect-to-cluster/java.rst
diff --git a/docs/howtos/connect-to-cluster/javascript.rst b/docs/howtos/connect-to-cluster/javascript.rst
diff --git a/docs/howtos/connect-to-cluster/php.rst b/docs/howtos/connect-to-cluster/php.rst
diff --git a/docs/howtos/connect-to-cluster/python.rst b/docs/howtos/connect-to-cluster/python.rst