crate · amotl · Aug 14, 2025 · Aug 13, 2025
diff --git a/docs/feature/document/index.md b/docs/feature/document/index.md
@@ -427,5 +427,5 @@ and about OBJECT indexing.
 :maxdepth: 1
 :hidden:
 
-learn
+Tutorial <tutorial>
 ```
diff --git a/docs/feature/document/learn.md → docs/feature/document/tutorial.md b/docs/feature/document/learn.md → docs/feature/document/tutorial.md
diff --git a/docs/feature/search/fts/index.md b/docs/feature/search/fts/index.md
@@ -374,7 +374,7 @@ and how they can be customized to specific needs, using plugins for CrateDB.
 
 options
 analyzer
-learn
+Tutorial <tutorial>
 :::
 
 

diff --git a/docs/feature/search/fts/learn.md → docs/feature/search/fts/tutorial.md b/docs/feature/search/fts/learn.md → docs/feature/search/fts/tutorial.md
diff --git a/docs/integrate/azure-functions/index.md b/docs/integrate/azure-functions/index.md
@@ -29,7 +29,7 @@ services, or storage services. See also [What is Azure Functions?].
 ::::{grid} 2
 
 :::{grid-item-card} Data Enrichment using IoT Hub, Azure Functions and CrateDB
-:link: azure-functions-learn
+:link: azure-functions-tutorial
 :link-type: ref
 A common pattern uses an Azure Function to enrich and ingest data
 into a CrateDB instance by connecting the function to an IoT Hub
@@ -42,7 +42,7 @@ new‑messages trigger.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 

diff --git a/docs/integrate/azure-functions/learn.rst → docs/integrate/azure-functions/tutorial.rst b/docs/integrate/azure-functions/learn.rst → docs/integrate/azure-functions/tutorial.rst
@@ -1,4 +1,4 @@
-.. _azure-functions-learn:
+.. _azure-functions-tutorial:
 
 ==========================================================
 Data Enrichment using IoT Hub, Azure Functions and CrateDB

diff --git a/docs/integrate/dbt/index.md b/docs/integrate/dbt/index.md
@@ -129,7 +129,7 @@ Learn how to use CrateDB with dbt by exploring a few examples.
 :gutter: 5
 
 :::{grid-item-card}
-:link: dbt-usage
+:link: dbt-tutorial
 :link-type: ref
 :link-alt: dbt usage guidelines
 :padding: 3
@@ -142,7 +142,7 @@ Usage Guidelines
 :maxdepth: 2
 :hidden:
 
-usage
+Tutorial <tutorial>
 ```
 +++
 Usage guidelines, notes, and advanced configuration options.

diff --git a/docs/integrate/dbt/usage.md → docs/integrate/dbt/tutorial.md b/docs/integrate/dbt/usage.md → docs/integrate/dbt/tutorial.md
@@ -1,4 +1,4 @@
-(dbt-usage)=
+(dbt-tutorial)=
 # Using dbt with CrateDB
 
 :::{include} /_include/links.md

diff --git a/docs/integrate/grafana/index.md b/docs/integrate/grafana/index.md
@@ -32,7 +32,7 @@ Get Grafana fully managed with [Grafana Cloud].
 ::::{grid} 2
 
 :::{grid-item-card} Visualize data with Grafana
-:link: visualize-data-with-grafana
+:link: grafana-tutorial
 :link-type: ref
 Grafana complements CrateDB in monitoring and visualizing large volumes of
 machine data in real-time.
@@ -55,7 +55,7 @@ Connecting to a CrateDB cluster uses the Grafana PostgreSQL data source adapter.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 

diff --git a/docs/integrate/grafana/learn.rst → docs/integrate/grafana/tutorial.rst b/docs/integrate/grafana/learn.rst → docs/integrate/grafana/tutorial.rst
@@ -1,5 +1,4 @@
-.. _integrations-grafana:
-.. _visualize-data-with-grafana:
+.. _grafana-tutorial:
 
 ===========================
 Visualize data with Grafana

diff --git a/docs/integrate/influxdb/index.md b/docs/integrate/influxdb/index.md
@@ -44,7 +44,7 @@ That's the blueprint for the InfluxDB URI:
 ::::{grid}
 
 :::{grid-item-card} Tutorial: Import data from InfluxDB
-:link: influxdb-learn
+:link: influxdb-tutorial
 :link-type: ref
 How to load data from InfluxDB Server and files in InfluxDB line protocol
 format (ILP) into CrateDB.
@@ -61,5 +61,5 @@ Load InfluxDB collections into CrateDB.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
diff --git a/docs/integrate/influxdb/learn.md → docs/integrate/influxdb/tutorial.md b/docs/integrate/influxdb/learn.md → docs/integrate/influxdb/tutorial.md
@@ -1,5 +1,4 @@
-(influxdb-learn)=
-(import-influxdb)=
+(influxdb-tutorial)=
 # Import data from InfluxDB
 
 In this quick tutorial, you will use the [CrateDB Toolkit InfluxDB I/O subsystem]

diff --git a/docs/integrate/marquez/index.md b/docs/integrate/marquez/index.md
@@ -32,7 +32,7 @@ runs of DAGs.
 ::::{grid} 2
 
 :::{grid-item-card} Tutorial: Use Marquez with CrateDB
-:link: marquez-learn
+:link: marquez-tutorial
 :link-type: ref
 Demonstrate how to run Airflow DAGs against a
 CrateDB database and view lineage data in Marquez.
@@ -42,7 +42,7 @@ CrateDB database and view lineage data in Marquez.
 
 :::{toctree}
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 

diff --git a/docs/integrate/marquez/learn.md → docs/integrate/marquez/tutorial.md b/docs/integrate/marquez/learn.md → docs/integrate/marquez/tutorial.md
@@ -1,4 +1,4 @@
-(marquez-learn)=
+(marquez-tutorial)=
 # Use Marquez with CrateDB
 
 This tutorial demonstrates how to run Airflow DAGs against a

diff --git a/docs/integrate/metabase/index.md b/docs/integrate/metabase/index.md
@@ -47,7 +47,7 @@ with none of the work or hidden costs that come with self-hosting.
 ::::{grid}
 
 :::{grid-item-card} Tutorial: Visualize data
-:link: integrations-metabase
+:link: metabase-tutorial
 :link-type: ref
 Visualize data with CrateDB and Metabase.
 :::
@@ -69,7 +69,7 @@ A fully working demo of Metabase connected to CrateDB.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 ```{seealso}

diff --git a/docs/integrate/metabase/learn.rst → docs/integrate/metabase/tutorial.rst b/docs/integrate/metabase/learn.rst → docs/integrate/metabase/tutorial.rst
@@ -1,4 +1,4 @@
-.. _integrations-metabase:
+.. _metabase-tutorial:
 
 Visualize data with Metabase
 ============================

diff --git a/docs/integrate/mongodb/index.md b/docs/integrate/mongodb/index.md
@@ -68,7 +68,7 @@ Data from MongoDB can also be loaded by other means.
 ::::{grid}
 
 :::{grid-item-card} Tutorial: Import data from MongoDB
-:link: mongodb-learn
+:link: mongodb-tutorial
 :link-type: ref
 How to load data from MongoDB Server and MongoDB Atlas into CrateDB.
 :::
@@ -93,7 +93,7 @@ into CrateDB (`cdc`), optionally using transformations.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 

diff --git a/docs/integrate/mongodb/learn.md → docs/integrate/mongodb/tutorial.md b/docs/integrate/mongodb/learn.md → docs/integrate/mongodb/tutorial.md
@@ -1,9 +1,4 @@
-(integrate-mongodb)=
-(migrating-mongodb)=
-(integrate-mongodb-quickstart)=
-(import-mongodb)=
-(mongodb-learn)=
-
+(mongodb-tutorial)=
 # Import data from MongoDB
 
 In this quick tutorial, you'll use the [CrateDB Toolkit MongoDB I/O subsystem]

diff --git a/docs/integrate/streamsets/index.md b/docs/integrate/streamsets/index.md
@@ -25,7 +25,7 @@ It runs on-premises or in any cloud.
 ::::{grid} 2
 
 :::{grid-item-card} Use StreamSet with CrateDB
-:link: streamsets-learn
+:link: streamsets-tutorial
 :link-type: ref
 Learn how to create data streaming pipelines
 using CrateDB and the StreamSets Data Collector.
@@ -36,7 +36,7 @@ using CrateDB and the StreamSets Data Collector.
 :::{toctree}
 :maxdepth: 1
 :hidden:
-learn
+Tutorial <tutorial>
 :::
 
 [StreamSets Data Collector]: https://www.softwareag.com/en_corporate/platform/integration-apis/data-collector-engine.html
diff --git a/docs/integrate/streamsets/learn.rst → docs/integrate/streamsets/tutorial.rst b/docs/integrate/streamsets/learn.rst → docs/integrate/streamsets/tutorial.rst
@@ -1,4 +1,4 @@
-.. _streamsets-learn:
+.. _streamsets-tutorial:
 
 ================================================================
 Data Stream Pipelines with CrateDB and StreamSets Data Collector
-Original file line number
+Diff line change
@@ Expand Up @@
     options
     analyzer
-    learn
+    Tutorial <tutorial>
     :::
@@ Expand Down @@