clickhouse credentials integration

docs/products/clickhouse/howto/data-service-integration.rst

@@ -1,35 +1,30 @@
-Manage Aiven for ClickHouse® data service integrations
+Set up Aiven for ClickHouse® data service integrations
 ======================================================
 
-Aiven for ClickHouse supports two types of integrations:
+Connect an Aiven for ClickHouse® service with another Aiven service or external data source to make your data available in the Aiven for ClickHouse service. Depending on your use case, select either the managed-database integration or the managed-credentials integration.
 
-- Regular integrations: Logs, metrics, dataflow/replication, and authentication integrations among your Aiven services and with external applications
-- Data service integrations: Integrations with other Aiven services to use them as data sources
-
-This article details how to set up and use data service integrations in Aiven for ClickHouse.
+About data service integrations
+-------------------------------
 
-.. seealso::
+Aiven for ClickHouse allows the in-Aiven integrations (between Aiven services) and external integrations (between an Aiven service and an external data source or application).
 
-    For information on how to set up and use regular integrations in Aiven for ClickHouse, see intregration guides in :doc:`Integrate your Aiven for ClickHouse® service </docs/products/clickhouse/howto/list-integrations>`.
+Depending on objectives and actual objects of the integration, Aiven for ClickHouse supports two types of integrations:
 
-About data service integrations
--------------------------------
+- :doc:`Observability integrations </docs/products/clickhouse/howto/list-integrations>`: connecting to other services (either in-Aiven or external) to expose and process logs and metrics
+- Data service integrations: connecting to other services (either in-Aiven or external) to use them as data sources
 
 By enabling data service integrations in Aiven for ClickHouse, you create streaming data pipelines across services. Aiven for ClickHouse supports data service integrations with Aiven for Kafka® and Aiven for PostgreSQL®.
 
-You can create Aiven for ClickHouse® data service integrations in the `Aiven web console <https://console.aiven.io/>`_.
+Aiven for ClickHouse provides two types of data service integrations:
 
-.. topic:: Integration databases
-
-   When creating integrations in the **Data service integrations** wizard, you can also create integration databases connected to the services you are integrating with.
-
-   If you prefer to create a data service integration without adding integration databases, you can create integration databases for your service any time later. See :doc:`Manage Aiven for ClickHouse® integration databases </docs/products/clickhouse/howto/integration-databases>` for guidance on how to do that.
+* Managed databases
+* Managed credentials
 
 Prerequisites
 -------------
 
-* Aiven account
-* Access to `Aiven web console <https://console.aiven.io/>`_
+* Aiven organization, project, and Aiven for ClickHouse service
+* Access to the `Aiven Console <https://console.aiven.io/>`_
 
 .. _create-data-service-integration:
 
@@ -61,6 +56,10 @@ Create data service integrations
 
 #. In the **Integration databases** view, select either **Enable without databases** or **Add databases** depending on whether you want to enable your integration with databases:
 
+.. note::
+
+   If you prefer to create a data service integration without adding integration databases, you can create integration databases for your service any time later. See :doc:`Manage Aiven for ClickHouse® integration databases </docs/products/clickhouse/howto/integration-databases>` for guidance on how to do that.
+
    - To enable your integration **with** databases:
 
      #. In the **Integration databases** view, select **Add databases**.