harmonize product naming across the documentation

.claude/docs-guidelines/repo-conventions.md

@@ -121,7 +121,10 @@ Do not write `index.html` stubs under `docs/`.
 - No absolute links to `https://documentation.eccenca.com/latest/...` for internal pages.
 - No base-relative links such as `/automate/...`.
 - Same-page references use a plain anchor: `[Configure OAuth clients](#configure-oauth-clients-helm)`, never a full path back to the same file.
-- `task check:links` runs the link checker; `task build` runs `zensical build --strict` and fails on unresolved internal links.
+- `task check:links` runs [lychee](https://lychee.cli.rs/) over the outgoing http(s) links; exclusions and accepted
+  status codes live in `lychee.toml`. `task build` runs `zensical build --strict` and fails on unresolved internal links.
+- An IRI written as an autolink (`<https://vocab.eccenca.com/...>`) is checked like any link. Identifier namespaces
+  that do not resolve are excluded in `lychee.toml`; add a new one there rather than formatting the IRI differently.
 
 ## Images
 

.github/workflows/pages.yml

@@ -70,7 +70,28 @@ jobs:
       - name: install packages
         run: sudo apt-get install -y libffi-dev libz-dev
 
+      - name: install lychee
+        env:
+          LYCHEE_VERSION: "0.24.2"
+          LYCHEE_ASSET: lychee-x86_64-unknown-linux-gnu
+          LYCHEE_RELEASES: https://github.com/lycheeverse/lychee/releases/download
+        run: |
+          curl -sSfL "${LYCHEE_RELEASES}/lychee-v${LYCHEE_VERSION}/${LYCHEE_ASSET}.tar.gz" \
+            | sudo tar -xz -C /usr/local/bin --strip-components=1 "${LYCHEE_ASSET}/lychee"
+          lychee --version
+
+      - name: load link check cache
+        uses: actions/cache@v4
+        with:
+          path: .lycheecache
+          # A new key per run saves the updated cache; restore-keys picks up the latest one.
+          # lychee itself re-checks entries older than max_cache_age (lychee.toml).
+          key: lychee-${{ github.run_id }}
+          restore-keys: lychee-
+
       - name: check
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: task check
 
       - name: build

.github/workflows/test.yml

@@ -61,7 +61,28 @@ jobs:
       - name: test
         run: task test:unit
 
+      - name: install lychee
+        env:
+          LYCHEE_VERSION: "0.24.2"
+          LYCHEE_ASSET: lychee-x86_64-unknown-linux-gnu
+          LYCHEE_RELEASES: https://github.com/lycheeverse/lychee/releases/download
+        run: |
+          curl -sSfL "${LYCHEE_RELEASES}/lychee-v${LYCHEE_VERSION}/${LYCHEE_ASSET}.tar.gz" \
+            | sudo tar -xz -C /usr/local/bin --strip-components=1 "${LYCHEE_ASSET}/lychee"
+          lychee --version
+
+      - name: load link check cache
+        uses: actions/cache@v4
+        with:
+          path: .lycheecache
+          # A new key per run saves the updated cache; restore-keys picks up the latest one.
+          # lychee itself re-checks entries older than max_cache_age (lychee.toml).
+          key: lychee-${{ github.run_id }}
+          restore-keys: lychee-
+
       - name: check
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: task check
 
       - name: Publish Test Results

.gitignore

@@ -10,6 +10,7 @@ tmp
 .python-version
 dist/
 .env
+.lycheecache
 *.sw[a-p]
 *~
 

CONTRIBUTING.md

@@ -33,6 +33,7 @@ The following tools you need locally to get started:
 
 - [poetry](https://python-poetry.org/)
 - [task](https://taskfile.dev/)
+- [lychee](https://lychee.cli.rs/) - the link checker behind `task check:links`
 - git, markdown editor
 
 On a few OS distributions (e.g. Arch Linux) the tool/binary is named `go-task`.
@@ -114,7 +115,7 @@ On this page is search function for icons available as well.
 |Success|Success admonitions are a type of documentation element used to highlight successful outcomes or positive results associated with a particular task, process, or feature|Graph is created successfully.|
 |Bug|A bug admonition include a description of the bug or issue, as well as steps that the user can take to avoid or work around the problem. It may also include information about when the bug will be fixed or patched, if applicable.|Users may experience issues with the file saving feature when running this software on Windows 10. To avoid data loss or corruption, be sure to save your work frequently and consider using an external backup device. Our development team is working to resolve this issue in the next software update.|
 |Example|The example admonition is typically used in instructional or educational documents to clarify complex concepts or demonstrate how to perform a specific task.|To create a new email account, click on the "Sign Up" button on the homepage and enter your name, email address, and desired password. Be sure to choose a strong password with a mix of uppercase and lowercase letters, numbers, and special characters. Once you have entered your information, click "Create Account" to complete the process.|
-|Task|The Task admonition type is used to describe a series of steps or tasks required to complete a process or action. Clear and concise descriptions of each step, along with any relevant details or instructions, should be included. It's helpful to use images or diagrams to illustrate the process. Overall, The Task admonition is useful for providing detailed instructions to readers.|Loading Data  into a CMEM involves 3 steps: </br> 1. Connect to the database. </br> 2. Choose the data file and appropriate file type. </br> 3. Run workflow to import.|
+|Task|The Task admonition type is used to describe a series of steps or tasks required to complete a process or action. Clear and concise descriptions of each step, along with any relevant details or instructions, should be included. It's helpful to use images or diagrams to illustrate the process. Overall, The Task admonition is useful for providing detailed instructions to readers.|Loading Data into eccenca Corporate Memory involves 3 steps: </br> 1. Connect to the database. </br> 2. Choose the data file and appropriate file type. </br> 3. Run workflow to import.|
 
 </details>
 

Taskfile.yml

@@ -118,11 +118,17 @@ tasks:
       - poetry run dec-tool check-zensical-output
 
   check:links:
-    desc: Check outgoing links
-    deps:
-      - install
+    desc: Check outgoing links (lychee, configured in lychee.toml)
+    summary: |
+      Checks the outgoing http(s) links of the Markdown sources under docs/
+      with lychee. Exclusions, accepted status codes and retries are set in
+      lychee.toml. Set GITHUB_TOKEN to avoid GitHub rate limits.
+      Shows a progress bar in a terminal; in CI (CI is set) it prints the summary only.
+    preconditions:
+      - sh: command -v lychee
+        msg: "lychee is not installed - see https://lychee.cli.rs/installation/ (e.g. brew install lychee)"
     cmds:
-      - poetry run linkcheckMarkdown -r docs 2>&1 | grep -v "ResourceWarning"
+      - lychee --config lychee.toml ${CI:+--no-progress} 'docs/**/*.md'
 
   test:
     desc: Run the Python unit test suite

data/integrations.yml

@@ -163,7 +163,7 @@ integrations:
   - name: GraphQL
     icon: ":simple-graphql:"
     content: |
-      Execute a {{p.cmem_plugin_graphql_workflow_graphql_GraphQLPlugin}} and process the result in a workflow.
+      Execute a {{p.cmem_plugin_graphql_Query}} and process the result in a workflow.
 
   - name: eMail / SMTP / IMAP
     icon: ":material-email-outline:"
@@ -254,7 +254,7 @@ integrations:
   - name: eccenca Marketplace
     icon: ":eccenca-module-marketplace:"
     content: |
-      Manage [Marketplace Packages](../../develop/packages/index.md) in workflows:
+      Manage [Marketplace Packages](../../develop/marketplace-packages/index.md) in workflows:
       [build package archives]({{p.cmem_plugin_packages_BuildPackages_ref}}),
       [bump their version]({{p.cmem_plugin_packages_BumpVersions_ref}}),
       [publish]({{p.cmem_plugin_packages_PublishPackages_ref}}) them to a Marketplace Server