Merge branch 'main' into feature/zensical

# Conflicts:
#	Taskfile.yml

Author: rpietzsch

.markdownlint.jsonc

@@ -1,5 +1,6 @@
 {
   "default": true,
+  "MD012": false,
   "MD013": false,
   "MD007": {
     "indent": 4
@@ -12,22 +13,24 @@
   },
   "MD033": {
     "allowed_elements": [
-      "figure",
-      "figcaption",
-      "div",
-      "details",
-      "summary",
       "a",
-      "p",
+      "br",
+      "cite",
+      "details",
+      "div",
+      "figcaption",
+      "figure",
       "img",
+      "p",
       "span",
-      "br"
+      "summary"
     ]
   },
   "MD035": false,
+  "MD036": false,
   "MD041": false,
   "MD045": false,
   "MD046": false,
   "MD059": false,
   "MD060": false
-}
+}

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 👍🎉 First off, thanks for taking the time to contribute! 🎉👍
 
-The following is a set of guidelines for contributing to the eccenca Corporate Memory documention project.
+The following is a set of guidelines for contributing to the eccenca Corporate Memory documentation project.
 
 ## How Can I Contribute?
 

Taskfile.yml

@@ -5,7 +5,9 @@ version: '3'
 
 vars:
   PUBLIC_BRANCH: published
-  CURRENT_VERSION: 25.3
+  CURRENT_VERSION: 26.1
+  MATERIAL_TAG: 9.6.14
+  MATERIAL_INSIDER_TAG: 9.6.14-insiders-4.53.16
 
 tasks:
 
@@ -101,15 +103,15 @@ tasks:
       ICON_DIR: overrides/.icons/eccenca
 
   update:cmemc:
-    desc: re-generates the cmemc command reference
+    desc: re-generates the cmemc command reference (needs local cmemc)
     cmds:
       - rm -rf {{.REFERENCE_DIR}}/*
       - cmemc manual --format markdown-multi-page --output-dir {{.REFERENCE_DIR}}
     vars:
       REFERENCE_DIR: docs/automate/cmemc-command-line-interface/command-reference
 
   update:shape-reference:
-    desc: re-generates the shape and datatype references
+    desc: re-generates the shape and datatype references (needs local CO)
     summary: >
       This task uses a running Corporate Memory to upload a specification for
       a custom markdown endpoint (see shapedocu.ttl in
@@ -144,12 +146,12 @@ tasks:
       SRC: tools/update-shape-reference
 
   update:di-reference:
-    desc: update the task and operator reference pages
+    desc: update the task and operator reference pages (needs local CO)
     cmds:
       - poetry run dec-tool update-di-reference
 
   update:integrations:
-    desc: update integrations page
+    desc: update integrations page (needs data/integrations.yml)
     cmds:
       - poetry run dec-tool update-integrations
 
@@ -189,7 +191,7 @@ tasks:
         } | xargs -0 poetry run rumdl --config .markdownlint.jsonc check --fix
 
   check:rumdl:
-    desc: run rumdl (md-linter) for style issues
+    desc: run rumdl (md-linter) for style issues without failing the check stage
     cmds:
       - mkdir -p ./dist
       - rm -f ./dist/md-lint-issues.xml
@@ -208,4 +210,7 @@ tasks:
 
           # no recursion (top-level only)
           find . -maxdepth 1 -type f -name '*.md' -print0
-        } | xargs -0 poetry run rumdl --config .markdownlint.jsonc check
+        } | xargs -0 poetry run rumdl --config .markdownlint.jsonc check || {
+          echo "rumdl reported markdown style issues; continuing without failing the check stage."
+          true
+        }

data/integrations.yml

@@ -256,61 +256,68 @@ integrations:
   # Databases
   #####
 
+  - name: Hive
+    icon: ":simple-apachehive:"
+    content: |
+      Read from or write to an embedded Apache {{p.Hive}} endpoint.
+
+  - name: pgvector
+    icon: ":black_large_square:"
+    content: |
+      Store vector embeddings into [pgvector](https://github.com/pgvector/pgvector)
+      using the {{p.cmem_plugin_pgvector_Search}}.
+
   - name: Neo4J
     icon: ":simple-neo4j:"
     content: |
       Use the {{p.neo4j}} dataset for reading and writing [Neo4j graphs](https://neo4j.com/).
 
-  - name: PostgreSQL
-    icon: ":simple-postgresql:"
+  - name: Snowflake
+    icon: ":simple-snowflake:"
     content: |
-      PostgreSQL can be accessed with the {{p.Jdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/org.postgresql/postgresql/versions).
+      Snowflake can be accessed with the {{p.SnowflakeJdbc}} dataset (JDBC driver included).
 
-  - name: MariaDB
-    icon: ":simple-mariadb:"
+  - name: Microsoft SQL
+    icon: ":material-microsoft:"
     content: |
-      MariaDB can be accessed with the {{p.Jdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/org.mariadb.jdbc/mariadb-java-client/overview).
+      The Microsoft SQL Server can be accessed with the {{p.Jdbc}} dataset (JDBC driver included).
 
-  - name: SQLite
-    icon: ":simple-sqlite:"
+  - name: PostgreSQL
+    icon: ":simple-postgresql:"
     content: |
-      SQLite can be accessed with the {{p.Jdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/org.xerial/sqlite-jdbc).
+      PostgreSQL can be accessed with the {{p.Jdbc}} dataset (JDBC driver included).
 
   - name: MySQL
     icon: ":simple-mysql:"
     content: |
-      MySQL can be accessed with the {{p.Jdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/org.mariadb.jdbc/mariadb-java-client/overview).
-
-  - name: Hive
-    icon: ":simple-apachehive:"
-    content: |
-      Read from or write to an embedded Apache {{p.Hive}} endpoint.
-
-  - name: Microsoft SQL
-    icon: ":material-microsoft:"
-    content: |
-      The Microsoft SQL Server can be accessed with the {{p.Jdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/com.microsoft.sqlserver/mssql-jdbc).
+      MySQL can be accessed with the {{p.Jdbc}} dataset (JDBC driver included).
 
-  - name: Snowflake
-    icon: ":simple-snowflake:"
+  - name: MariaDB
+    icon: ":simple-mariadb:"
     content: |
-      Snowflake can be accessed with the {{p.SnowflakeJdbc}} dataset and a
-      [JDBC driver](https://central.sonatype.com/artifact/net.snowflake/snowflake-jdbc).
+      MariaDB can be accessed with the {{p.Jdbc}} dataset (JDBC driver included).
 
-  - name: pgvector
-    icon: ":black_large_square:"
+  - name: SQLite
+    icon: ":simple-sqlite:"
     content: |
-      Store vector embeddings into [pgvector](https://github.com/pgvector/pgvector)
-      using the {{p.cmem_plugin_pgvector_Search}}.
+      SQLite can be accessed with the {{p.Jdbc}} dataset and a
+      [Custom JDBC driver](https://central.sonatype.com/artifact/org.xerial/sqlite-jdbc).
+      Please have a look at
+      [Setup and use of JDBC Drivers](../../deploy-and-configure/configuration/dataintegration/jdbc/index.md).
 
   - name: Trino
     icon: ":simple-trino:"
     content: |
-      [Trino](https://github.com/trinodb/trino) can be access with the
-      {{p.Jdbc}} dataset and a [JDBC driver](https://trino.io/docs/current/client/jdbc.html).
+      [Trino](https://github.com/trinodb/trino) can be access with the {{p.Jdbc}} dataset and a
+      [Custom JDBC driver](https://trino.io/docs/current/client/jdbc.html).
+      Please have a look at
+      [Setup and use of JDBC Drivers](../../deploy-and-configure/configuration/dataintegration/jdbc/index.md).
+
+  - name: Databricks
+    icon: ":simple-databricks:"
+    content: |
+      [Databricks](http://databricks.com/) can be accessed with the {{p.Jdbc}} dataset and a
+      [Custom JDBC driver](https://github.com/databricks/databricks-jdbc).
+      Please have a look at
+      [Setup and use of JDBC Drivers](../../deploy-and-configure/configuration/dataintegration/jdbc/index.md).