ETL/CDC: Implement suggestions by CodeRabbit

amotl · amotl · commit 7264bf92e9a0 · 2025-08-10T22:28:21.000+02:00
diff --git a/docs/_include/links.md b/docs/_include/links.md
@@ -1,3 +1,5 @@
+<!-- markdownlint-disable MD053 -->
+
 [Amazon DynamoDB Streams]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html
 [Amazon Kinesis Data Streams]: https://docs.aws.amazon.com/streams/latest/dev/introduction.html
 [Apache Airflow]: https://airflow.apache.org/
@@ -21,9 +23,9 @@
 [Datashader]: https://datashader.org/
 [Dynamic Database Schemas]: https://cratedb.com/product/features/dynamic-schemas
 [DynamoDB]: https://aws.amazon.com/dynamodb/
-[DynamoDB CDC Relay]: https://cratedb-toolkit.readthedocs.io/io/dynamodb/cdc.html
-[DynamoDB CDC Relay with AWS Lambda]: https://cratedb-toolkit.readthedocs.io/io/dynamodb/cdc-lambda.html
-[DynamoDB Table Loader]: https://cratedb-toolkit.readthedocs.io/io/dynamodb/loader.html
+[DynamoDB CDC Relay]: inv:ctk:*:label#dynamodb-cdc
+[DynamoDB CDC Relay with AWS Lambda]: inv:ctk:*:doc#io/dynamodb/cdc-lambda
+[DynamoDB Table Loader]: inv:ctk:*:label#dynamodb-loader
 [Executable stack with Apache Kafka, Apache Flink, and CrateDB]: https://github.com/crate/cratedb-examples/tree/main/framework/flink/kafka-jdbcsink-java
 [Geospatial Data Model]: https://cratedb.com/data-model/geospatial
 [Geospatial Database]: https://cratedb.com/geospatial-spatial-database
diff --git a/docs/_include/styles.html b/docs/_include/styles.html
@@ -47,10 +47,8 @@
 }
 
 /* On tiled link overview index pages, give ul/li elements more space */
-.ul-li-wide {
-  ul li {
-    margin-bottom: 1rem;
-  }
+.ul-li-wide ul li {
+  margin-bottom: 1rem;
 }
 
 </style>
diff --git a/docs/connect/drivers.md b/docs/connect/drivers.md
@@ -359,6 +359,6 @@ Ruby on Rails ActiveRecord adapter for CrateDB.
 
 
 ```{tip}
-Please visit the [](#build-status) page for an overview about the integration
+Please visit the {ref}`build-status` page for an overview about the integration
 status of the client drivers listed above, and more.
 ```
diff --git a/docs/ingest/cdc/index.md b/docs/ingest/cdc/index.md
@@ -13,7 +13,7 @@ features.
 This documentation section lists CDC applications,
 frameworks, and solutions, which can be used together with CrateDB,
 and outlines how to use them optimally.
-Please also take a look at support for {ref}`generic ETL <etl>` solutions.
+Additionally, see support for {ref}`generic ETL <etl>` solutions.
 :::
 
 
@@ -67,7 +67,7 @@ kinds of databases.
 ::::{grid-item-card} Debezium
 :link: debezium
 :link-type: ref
-Use, Debezium an open source distributed platform for change data capture for
+Use Debezium, an open source distributed platform for change data capture for
 loading data into CrateDB.
 It is used as a building block by a number of downstream third-party projects and products.
 ::::
@@ -92,9 +92,8 @@ Python interface. It is available for on-premises and as a managed service.
 ::::{grid-item-card} StreamSets
 :link: streamsets
 :link-type: ref
-Use the StreamSets Data Collector Engine to ingest and transform data from a variety
-of sources into CrateDB. It runs on-premises or in any cloud.
+Use the StreamSets Data Collector Engine to ingest and transform data from many
+sources into CrateDB. It runs on-premises or in any cloud.
 ::::
 
 :::::
-
diff --git a/docs/ingest/etl/index.md b/docs/ingest/etl/index.md
@@ -17,7 +17,7 @@ features.
 This documentation section lists ETL applications and
 frameworks which can be used together with CrateDB, and outlines how
 to use them optimally.
-Please also take a look at support for {ref}`cdc` solutions.
+Additionally, see support for {ref}`cdc` solutions.
 :::
 
 
@@ -34,7 +34,7 @@ Please also take a look at support for {ref}`cdc` solutions.
 ::::{grid-item-card} {material-outlined}`air;2em` Dataflow / Pipeline / Code-first
 - {ref}`apache-airflow`
 
-  Apache Airflow is an open source software platform to programmatically author,
+  Apache Airflow is an open-source software platform to programmatically author,
   schedule, and monitor workflows. Pipelines are defined in Python, allowing for
   dynamic pipeline generation and on-demand, code-driven pipeline invocation.
 
@@ -57,15 +57,15 @@ Please also take a look at support for {ref}`cdc` solutions.
 
 - {ref}`kestra`
 
-  Kestra is an open source workflow automation and orchestration toolkit with a rich
+  Kestra is an open-source workflow automation and orchestration toolkit with a rich
   plugin ecosystem. It enables users to automate and manage complex workflows in a
   streamlined and efficient manner, defining them both declaratively, or imperatively
   using any scripting language like Python, Bash, or JavaScript.
 
 - {ref}`meltano`
 
   Meltano is a declarative code-first polyglot data integration engine adhering to
-  the Singer specification. Singer is a composable open source ETL framework and
+  the Singer specification. Singer is a composable open-source ETL framework and
   specification, including powerful data extraction and consolidation elements.
 
 +++
@@ -162,8 +162,8 @@ Load data from database systems.
 - {ref}`streamsets`
 
   The StreamSets Data Collector is a lightweight and powerful engine that allows you
-  to build streaming, batch and change-data-capture (CDC) pipelines that can ingest
-  and transform data from a variety of sources.
+  to build streaming, batch, and change-data-capture (CDC) pipelines that can ingest
+  and transform data from many sources.
 
 +++
 Load data from streaming platforms.
diff --git a/docs/integrate/apache-airflow/index.md b/docs/integrate/apache-airflow/index.md
@@ -11,9 +11,9 @@
 
 ```{div}
 :style: "float: right"
-[![](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){w=180px}](https://airflow.apache.org/)
+[![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){w=180px}](https://airflow.apache.org/)
 
-[![](https://logowik.com/content/uploads/images/astronomer2824.jpg){w=180px}](https://www.astronomer.io/)
+[![Astronomer logo](https://logowik.com/content/uploads/images/astronomer2824.jpg){w=180px}](https://www.astronomer.io/)
 ```
 :::{div}
 [Apache Airflow] is an open source software platform to programmatically author,
diff --git a/docs/integrate/aws-lambda/index.md b/docs/integrate/aws-lambda/index.md
@@ -9,8 +9,8 @@
 
 :::{div}
 [AWS Lambda] is a serverless compute service that runs your code in response to
-events and automatically manages the underlying compute resources for you. These
-events may include changes in state or an update.
+events and automatically manages the underlying compute resources for you.
+Events can include state changes and updates.
 :::
 
 :::{rubric} Learn
diff --git a/docs/integrate/n8n/index.md b/docs/integrate/n8n/index.md
@@ -5,14 +5,16 @@
 :::
 
 [n8n] is a fair-code licensed workflow automation tool that combines AI capabilities
-with business process automation. It helps you to connect any app with an API with
+with business process automation. It helps you connect any app with an API to
 any other, and manipulate its data with little or no code.
 
 :::{rubric} Learn
 :::
 
-- https://cratedb.com/integrations/cratedb-and-n8n
-- https://n8n.io/integrations/cratedb/
+- [CrateDB and n8n integration]
+- [n8n CrateDB integration]
 
 
+[CrateDB and n8n integration]: https://cratedb.com/integrations/cratedb-and-n8n
 [n8n]: https://docs.n8n.io/
+[n8n CrateDB integration]: https://n8n.io/integrations/cratedb/

Original file line number	Diff line number	Diff line change
`@@ -47,10 +47,8 @@`
`47`	`47`	`}`
`48`	`48`
`49`	`49`	`/* On tiled link overview index pages, give ul/li elements more space */`
`50`		`-.ul-li-wide {`
`51`		`- ul li {`
`52`		`- margin-bottom: 1rem;`
`53`		`- }`
	`50`	`+.ul-li-wide ul li {`
	`51`	`+ margin-bottom: 1rem;`
`54`	`52`	`}`
`55`	`53`
`56`	`54`	`</style>`