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;
@@ -37,7 +46,7 @@ TODO: Upstream to crate-docs-theme.
 }
 .no-margin > * {
   margin-top: 0 !important;
-  margin-bottom: 0 !important;;
+  margin-bottom: 0 !important;
 }
 
 
@@ -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"
-[![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} .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){height=60px loading=lazy}][Apache Airflow]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About
@@ -20,16 +18,16 @@
 :::{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**
 Airflow has a modular architecture and uses a message queue to orchestrate an
 arbitrary number of workers. Pipelines are defined in Python, allowing for
 dynamic pipeline generation and on-demand, code-driven pipeline invocation.
 
-Pipeline parametrization is using the powerful Jinja templating engine.
+Pipeline parameterization is using the powerful Jinja templating engine.
 To extend the system, you can define your own operators and extend libraries
 to fit the level of abstraction that suits your environment.
 :::
@@ -55,16 +53,16 @@ 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
 ```
+
 :::
 
 
 :::{rubric} Learn: Starter Tutorials
 :::
 
-::::{grid}
+::::{grid} 2
 
 :::{grid-item-card} Tutorial: Import Parquet files
 :link: https://community.cratedb.com/t/automating-the-import-of-parquet-files-with-apache-airflow/1247
@@ -85,7 +83,7 @@ into CrateDB.
 :::{rubric} Learn: Advanced Tutorials
 :::
 
-::::{grid}
+::::{grid} 3
 
 :::{grid-item-card} Tutorial: Export to S3
 :link: https://community.cratedb.com/t/cratedb-and-apache-airflow-automating-data-export-to-s3/901
@@ -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"
-[![Apache Hop logo](https://hop.apache.org/img/hop-logo.svg){h=60px}][Apache Hop]
+```{div} .float-right
+[![Apache Hop logo](https://hop.apache.org/img/hop-logo.svg){height=60px loading=lazy}][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"
-[![Apache Iceberg logo](https://iceberg.apache.org/assets/images/Iceberg-logo.svg){h=60px}][Apache Iceberg]
+```{div} .float-right
+[![Apache Iceberg logo](https://iceberg.apache.org/assets/images/Iceberg-logo.svg){height=60px loading=lazy}][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"
-[![Apache NiFi logo](https://nifi.apache.org/images/apache-nifi-drop-logo.svg){h=60px}][Apache NiFi]
+```{div} .float-right
+[![Apache NiFi logo](https://nifi.apache.org/images/apache-nifi-drop-logo.svg){height=60px loading=lazy}][Apache NiFi]
 ```
-```{div}
-:style: "clear: both"
+```{div} .clearfix
 ```
 
 :::{rubric} About
@@ -20,18 +18,18 @@ worldwide across every industry.
 :::{dropdown} **Details**
 
 - **Data provenance tracking**: Complete lineage of information from beginning to end.
-- **Extensive configuration**: Loss-tolerant and guaranteed delivery, Low latency and
+- **Extensive configuration**: Loss-tolerant and guaranteed delivery, low latency and
   high throughput, Dynamic prioritization, Runtime modification of flow configuration,
   Back pressure control.
 - **Browser-based user interface**: Seamless experience for design, control, feedback,
   and monitoring
 - **Secure communication**: HTTPS with configurable authentication strategies,
-  Multi-tenant authorization and policy management, Standard protocols for encrypted
+  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){height=120px loading=lazy}
+![NiFi flow canvas screenshot 2](https://github.com/crate/crate-clients-tools/assets/453543/7fd4d2e7-98bc-44ee-b441-e1835016ab4d){height=120px loading=lazy}
+![NiFi processors screenshot](https://github.com/crate/crate-clients-tools/assets/453543/ccfa4ac7-0d60-432f-b952-2b50789cd325){height=120px loading=lazy}
 
 :::