ETL/CDC: Implement suggestions by CodeRabbit

Author: amotl

docs/_include/links.md

@@ -1,3 +1,4 @@
+<!-- markdownlint-disable MD034 -->
 <!-- markdownlint-disable MD053 -->
 
 [Amazon DynamoDB Streams]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html

docs/_static/css/custom.css

@@ -5,6 +5,15 @@ TODO: Upstream to crate-docs-theme.
 */
 
 /* General */
+.float-right {
+    float: right;
+}
+.clearfix {
+    clear: both;
+}
+.text-right {
+    text-align: right;
+}
 /*
 .sd-card-body {
     line-height: 1.1em;
@@ -52,6 +61,14 @@ TODO: Upstream to crate-docs-theme.
 }
 
 /* When a logo wants to be displayed next to the title */
+
 #main-content h1 {
-    display: inline-block;
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem; /* space between logo and title */
+}
+/* Optional: ensure logos inside h1 scale and align nicely */
+#main-content h1 img {
+    vertical-align: middle;
+    max-height: 2rem; /* adjust as needed per design */
 }

docs/ingest/cdc/index.md

@@ -5,15 +5,13 @@
 :::
 
 :::{div}
-Options to connect and integrate CrateDB with third-party
-CDC applications, mostly using [CrateDB's PostgreSQL interface].
-CrateDB also provides native adapter components to leverage advanced
-features.
-
-This documentation section lists CDC applications,
-frameworks, and solutions, which can be used together with CrateDB,
-and outlines how to use them optimally.
-Additionally, see support for {ref}`generic ETL <etl>` solutions.
+Options to integrate CrateDB with third‑party CDC applications, typically via
+[CrateDB's PostgreSQL interface]. CrateDB also provides native adapter components
+to leverage advanced features.
+
+This section lists ETL applications and frameworks that work with CrateDB, and
+outlines how to use them effectively. Additionally, see support for
+{ref}`generic ETL <etl>` solutions.
 :::
 
 

docs/ingest/etl/index.md

@@ -7,15 +7,12 @@
 :::
 
 :::{div}
-Options to connect and integrate CrateDB with third-party
-ETL applications, mostly using [CrateDB's PostgreSQL interface].
-CrateDB also provides native adapter components to leverage advanced
-features.
-
-This documentation section lists ETL applications and
-frameworks which can be used together with CrateDB, and outlines how
-to use them optimally.
-Additionally, see support for {ref}`cdc` solutions.
+Options to integrate CrateDB with third‑party ETL applications, typically via
+[CrateDB's PostgreSQL interface]. CrateDB also provides native adapter components
+to leverage advanced features.
+
+This section lists ETL applications and frameworks that work with CrateDB, and
+outlines how to use them effectively. Additionally, see support for {ref}`cdc` solutions.
 :::
 
 
@@ -67,7 +64,7 @@ Additionally, see support for {ref}`cdc` solutions.
   specification, including powerful data extraction and consolidation elements.
 
 +++
-Data pipeline programming frameworks and platforms.
+Use data pipeline programming frameworks and platforms.
 ::::
 
 
@@ -95,7 +92,7 @@ Data pipeline programming frameworks and platforms.
   applications.
 
 +++
-Visual data flow and integration frameworks and platforms.
+Use visual data flow and integration frameworks and platforms.
 ::::
 
 

docs/integrate/apache-airflow/index.md

@@ -6,12 +6,10 @@
 :::{include} /_include/links.md
 :::
 
-```{div}
-:style: "float: right"
+```{div} .float-right
 [![Apache Airflow logo](https://19927462.fs1.hubspotusercontent-na1.net/hub/19927462/hubfs/Partner%20Logos/392x140/Apache-Airflow-Logo-392x140.png?width=784&height=280&name=Apache-Airflow-Logo-392x140.png){h=60px}][Apache Airflow]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About
@@ -20,8 +18,8 @@
 :::{div}
 [Apache Airflow] is an open source software platform to programmatically author,
 schedule, and monitor workflows, written in Python.
-[Astronomer] offers managed Airflow services on the cloud of your choice, in
-order to run Airflow with less overhead.
+[Astronomer] offers managed Airflow services on the cloud of your choice, to
+run Airflow with less overhead.
 :::
 
 :::{dropdown} **Details**
@@ -55,9 +53,9 @@ journey. Spend time where it counts.
   behind the project. Get world-class support, fast-tracked bug fixes, and same-day
   access to new Airflow versions.
 
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
+
 :::
 
 
@@ -112,7 +110,7 @@ and cost-effectiveness.
 
 
 ```{seealso}
-**Repository:** https://github.com/crate/cratedb-airflow-tutorial
+**Repository:** <https://github.com/crate/cratedb-airflow-tutorial>
 <br>
 **Product:** [CrateDB and Apache Airflow]
 <br>

docs/integrate/apache-flink/index.md

@@ -5,15 +5,13 @@
 :::{include} /_include/links.md
 :::
 
-```{div}
-:style: "float: right; text-align: right"
-[![Apache Flink logo](https://flink.apache.org/flink-header-logo.svg){h=60px}][Apache Flink]
+```{div} .float-right .text-right
+[![Apache Flink logo](https://flink.apache.org/flink-header-logo.svg){height=60px loading=lazy}][Apache Flink]
 <br>
-<a href="https://github.com/crate/cratedb-examples/actions/workflows/framework-flink-kafka-java.yml" target="_blank">
-    <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"></a>
+<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>
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 [Apache Flink] is a programming framework and distributed processing engine
@@ -33,7 +31,7 @@ Systems Award].
 ![](https://flink.apache.org/img/flink-home-graphic.png){h=200px}
 
 :::{dropdown} **Managed Flink**
-A few companies are specializing in offering managed                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            Flink services.
+A few companies are specializing in offering managed Flink services.
 
 - [Aiven] offers their managed [Aiven for Apache Flink] solution.
 - [Immerok Cloud]'s offering is being converged into [Flink managed by Confluent],

docs/integrate/apache-hop/index.md

@@ -1,12 +1,10 @@
 (apache-hop)=
 # Apache Hop
 
-```{div}
-:style: "float: right"
+```{div} .float-right
 [![Apache Hop logo](https://hop.apache.org/img/hop-logo.svg){h=60px}][Apache Hop]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About
@@ -28,9 +26,9 @@ orchestration.
 - **Lifecycle Management** enables developers and administrators to switch between
   projects, environments and purposes without leaving your train of thought.
 
-![](https://github.com/crate/crate-clients-tools/assets/453543/da6baf11-8430-4a0f-b2df-55717ce02802){h=120px}
-![](https://github.com/crate/crate-clients-tools/assets/453543/60cfc82a-db0a-49f1-8e26-a37b774b3614){h=120px}
-![](https://github.com/crate/crate-clients-tools/assets/453543/2bd59577-b664-45ae-a71e-36a130d36739){h=120px}
+![Apache Hop pipeline editor screenshot](https://github.com/crate/crate-clients-tools/assets/453543/da6baf11-8430-4a0f-b2df-55717ce02802){h=120px}
+![Apache Hop workflow view screenshot](https://github.com/crate/crate-clients-tools/assets/453543/60cfc82a-db0a-49f1-8e26-a37b774b3614){h=120px}
+![Apache Hop execution monitor screenshot](https://github.com/crate/crate-clients-tools/assets/453543/2bd59577-b664-45ae-a71e-36a130d36739){h=120px}
 
 :::
 

docs/integrate/apache-iceberg/index.md

@@ -1,12 +1,10 @@
 (apache-iceberg)=
 # Apache Iceberg
 
-```{div}
-:style: "float: right"
+```{div} .float-right
 [![Apache Iceberg logo](https://iceberg.apache.org/assets/images/Iceberg-logo.svg){h=60px}][Apache Iceberg]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About

docs/integrate/apache-kafka/index.md

@@ -1,15 +1,13 @@
 (apache-kafka)=
 # Apache Kafka
 
-```{div}
-:style: "float: right; text-align: right"
-[![Apache Kafka logo](https://kafka.apache.org/logos/kafka_logo--simple.png){h=60px}][Apache Kafka]
+```{div} .float-right .text-right
+[![Apache Kafka logo](https://kafka.apache.org/logos/kafka_logo--simple.png){height=60px loading=lazy}][Apache Kafka]
 <br>
-<a href="https://github.com/crate/cratedb-examples/actions/workflows/framework-flink-kafka-java.yml" target="_blank">
-    <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"></a>
+<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>
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{include} /_include/links.md

docs/integrate/apache-nifi/index.md

@@ -1,12 +1,10 @@
 (apache-nifi)=
 # Apache NiFi
 
-```{div}
-:style: "float: right"
+```{div} .float-right
 [![Apache NiFi logo](https://nifi.apache.org/images/apache-nifi-drop-logo.svg){h=60px}][Apache NiFi]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About
@@ -29,9 +27,9 @@ worldwide across every industry.
   Multi-tenant authorization and policy management, Standard protocols for encrypted
   communication including TLS and SSH.
 
-![](https://github.com/crate/crate-clients-tools/assets/453543/ba6973dd-2eec-4f1f-a436-96aac7eb9892){h=120px}
-![](https://github.com/crate/crate-clients-tools/assets/453543/7fd4d2e7-98bc-44ee-b441-e1835016ab4d){h=120px}
-![](https://github.com/crate/crate-clients-tools/assets/453543/ccfa4ac7-0d60-432f-b952-2b50789cd325){h=120px}
+![NiFi flow canvas screenshot 1](https://github.com/crate/crate-clients-tools/assets/453543/ba6973dd-2eec-4f1f-a436-96aac7eb9892){h=120px}
+![NiFi flow canvas screenshot 2](https://github.com/crate/crate-clients-tools/assets/453543/7fd4d2e7-98bc-44ee-b441-e1835016ab4d){h=120px}
+![NiFi processors screenshot](https://github.com/crate/crate-clients-tools/assets/453543/ccfa4ac7-0d60-432f-b952-2b50789cd325){h=120px}
 
 :::