revise / refine text

Author: rpietzsch

docs/deploy-and-configure/configuration/dataintegration/jdbc/index.md

@@ -5,49 +5,50 @@ tags:
 ---
 # Setup and use of JDBC Drivers
 
-Corporate Memory allows to use JDBC to connect to Database Management Systems (DBMS).
-We ship some drivers as part of our platform.
-Custom drivers can be added and used, too.
+Corporate Memory supports JDBC connections to database management systems (DBMSs).
+The platform includes several JDBC drivers by default.
+You can also add and use custom drivers.
 
 !!! info "References"
 
-    For more technical details also check the following reference pages:
+    For more technical details, see the following reference pages:
 
     -   [Remote SQL endpoint](../../../../build/reference/dataset/Jdbc.md) and
     -   [Snowflake SQL endpoint](../../../../build/reference/dataset/SnowflakeJdbc.md).
 
-## Embedded JDBC Driver
+## Bundled JDBC Drivers
 
-Our platform contains and ship the following JDBC drivers:
+The platform includes the following JDBC drivers:
 
 -   PostgreSQL (`postgresql v42.7.10`)
 -   MariaDB (includes support for MySQL, `mariadb-java-client v3.5.7`)
 -   Microsoft SQL Server (`mssql-jdbc v13.2.1.jre11`)
 -   Snowflake (`snowflake-jdbc v3.28.0`)
 
-## Custom JDBC Driver
+## Custom JDBC Drivers
 
-In addition to the shipped default JDBC drivers custom JDBC drivers can be registered.
-The following steps describe how they are configured.
+In addition to the bundled JDBC drivers, you can register custom JDBC drivers.
+The following sections describe the required configuration.
 
 ### Download Custom JDBC Driver
 
-Download the respective JDBC driver for the Database Management Systems that need to be connected.
-[Integrations](../../../../build/integrations/index.md) provides links for well know system and at the same time lists those that are in active use with Corporate Memory.
+Download the JDBC driver for each database management system that you want to connect to.
+[Integrations](../../../../build/integrations/index.md) provides links for well-known systems and lists those that are actively used with Corporate Memory.
 
 ### Provide a Custom JDBC Driver
 
-Consult your solutions manager or DevOps specialist for options how to copy / inject additional files, namely the JDBC driver `jar`, into a Corporate Memory deployment.
-Depending on the specific deployment model used the suitable options differ, some possibilities:
+Consult your solutions manager or DevOps specialist for options to copy or inject the JDBC driver `jar` into a Corporate Memory deployment.
+Depending on the deployment model, suitable options include:
 
--   the docker compose package `cmem-orchestration` mounts the folder `./conf/dataintegration/plugin/` into the DataIntegration container (this location is assumed in the configuration snippets below and mapped to the container internal path `/opt/cmem/eccenca-DataIntegration/dist/etc/dataintegration/conf/plugin/`),
--   a dedicated Build project into which the driver jar files are uploaded as project (file) resources,
--   dedicated file or resource mounts in a docker compose or helm/kubernets configuration.
+-   The Docker Compose package `cmem-orchestration` mounts the folder `./conf/dataintegration/plugin/` into the DataIntegration container.
+    The configuration snippets below assume this location, which maps to `/opt/cmem/eccenca-DataIntegration/dist/etc/dataintegration/conf/plugin/` inside the container.
+-   A dedicated _Build project_ in which the driver JAR files are uploaded as project file resources.
+-   Dedicated file or resource mounts in a Docker Compose or Helm/Kubernetes configuration.
 
 ## Driver Registration
 
-A custom JDBC driver needs to be registered in the DataIntegration configuration file, `dataintegration.conf`, `spark.sql.options` section.
-The following example demonstrates how to register the custom JDBC driver for the Databricks data lakehouse:
+A custom JDBC driver must be registered in the DataIntegration configuration file `dataintegration.conf`, in the `spark.sql.options` section.
+The following example shows how to register a custom JDBC driver for Databricks:
 
 ```conf
 …
@@ -64,12 +65,13 @@ spark.sql.options {
 …
 ```
 
-## Use the driver
+## Use the Driver
 
-JDBC drivers are used via the **Remote SQL endpoint** (or **Snowflake SQL endpoint**) dataset type.
+JDBC drivers are used through the **Remote SQL endpoint** or **Snowflake SQL endpoint** dataset type.
 
 ![](jdbc-dataset.png){ class="bordered" width="85%" }
 
-They can be configured in the configuration dialog of the dataset, consult the documentation of your DBMS / JDBC driver for details about the [JDBC connection string](https://www.baeldung.com/java-jdbc-url-format).
+Configure them in the dataset configuration dialog.
+For details about the JDBC connection string, consult your DBMS or JDBC driver documentation.
 
 ![](jdbc-config-databricks.png){ class="bordered" width="100%" }