Integrate/Kafka: Implement suggestions by CodeRabbit

Author: amotl

docs/integrate/kafka/docker-python.md

@@ -47,12 +47,12 @@ docker compose up -d
 
 ## Provisioning CrateDB and Kafka
 
-* CrateDB Admin UI: http://localhost:4200
+* CrateDB Admin UI: `http://localhost:4200`
 * Kafka broker (inside-compose hostname): kafka:9092
 
 ### Create a demo table in CrateDB
 
-The easiest way to do this is through the CrateDB cloud UI at http://localhost:4200 and execute this using the console:
+The easiest way to do this is through the CrateDB cloud UI at `http://localhost:4200` and execute this using the console:
 
 ```sql
 CREATE TABLE IF NOT EXISTS sensor_readings (

docs/integrate/kafka/index.md

@@ -12,7 +12,7 @@ description: >-
 <a href="https://github.com/crate/cratedb-examples/actions/workflows/framework-flink-kafka-java.yml" target="_blank" rel="noopener noreferrer">
     <img src="https://img.shields.io/github/actions/workflow/status/crate/cratedb-examples/framework-flink-kafka-java.yml?branch=main&label=Apache%20Kafka,%20Apache%20Flink" loading="lazy" alt="CI status: Apache Kafka, Apache Flink"></a>
 <a href="https://github.com/crate/cratedb-examples/actions/workflows/application-ingestr.yml" target="_blank" rel="noopener noreferrer">
-    <img src="https://img.shields.io/github/actions/workflow/status/crate/cratedb-examples/application-ingestr.yml?branch=main&label=Ingestr%2BKafka" loading="lazy" alt="CI status: Apache Kafka, Apache Flink"></a>
+    <img src="https://img.shields.io/github/actions/workflow/status/crate/cratedb-examples/application-ingestr.yml?branch=main&label=Ingestr%2BKafka" loading="lazy" alt="CI status: Ingestr + Kafka"></a>
 ```
 ```{div} .clearfix
 ```
@@ -39,7 +39,7 @@ Apache Kafka is a widely used open-source distributed event-store and streaming
 ## Common Ingestion Options
 
 :::{important}
-The Apache Kafka PostgreSQL connector is 99% compatible with CrateDB. CrateDB does not support transactions, but this only becomes notable when either ingestion to CrateDB is failing or there is some other connection issue.&#x20;
+The Apache Kafka PostgreSQL connector is largely compatible with CrateDB. Note that CrateDB does not support transactions; this generally matters only during failures or connection issues that require retries or rollbacks.
 :::
 
 ### Kafka Connect → CrateDB (recommended for most)

docs/integrate/kafka/kafka-connect.md

@@ -233,15 +233,15 @@ data transfer:
 Launch all the services defined in the `docker-compose.yml` file:
 
 ```bash
-docker-compose up -d
+docker compose up -d
 ```
 
 ## Verify the Running Containers
 
 Ensure that all services are up and running by listing the active containers:
 
 ```bash
-docker-compose ps
+docker compose ps
 ```
 
 You should see the following containers: