From c57effb27c7327c33437ad1873b928736a2c3a34 Mon Sep 17 00:00:00 2001
From: JW Wesson <wesson@textkernel.nl>
Date: Thu, 24 Jul 2025 14:18:26 -0500
Subject: [PATCH 1/2] try updating docs build

---
 .github/workflows/docs-publish.yml | 4 ++--
 docfx/docfx.json                   | 2 --
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/docs-publish.yml b/.github/workflows/docs-publish.yml
index fe888839..d38a93bf 100644
--- a/.github/workflows/docs-publish.yml
+++ b/.github/workflows/docs-publish.yml
@@ -20,9 +20,9 @@ jobs:
     - name: Setup .NET Core
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: 3.1.x
+        dotnet-version: 8.x
     - name: Setup DocFX
-      uses: crazy-max/ghaction-chocolatey@v1
+      uses: crazy-max/ghaction-chocolatey@v3
       with:
         args: install docfx
     - name: Install dependencies
diff --git a/docfx/docfx.json b/docfx/docfx.json
index a8f33f15..124a0424 100644
--- a/docfx/docfx.json
+++ b/docfx/docfx.json
@@ -24,8 +24,6 @@
       },
       {
         "files": [
-          "examples/**.md",
-          "examples/**/toc.yml",
           "toc.yml",
           "*.md"
         ]

From 4466010b5befe8d65e989da660d7b00a13983a95 Mon Sep 17 00:00:00 2001
From: JW Wesson <wesson@textkernel.nl>
Date: Thu, 24 Jul 2025 14:31:00 -0500
Subject: [PATCH 2/2] try using predefined action

---
 .github/workflows/docs-publish.yml | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/docs-publish.yml b/.github/workflows/docs-publish.yml
index d38a93bf..bbcae372 100644
--- a/.github/workflows/docs-publish.yml
+++ b/.github/workflows/docs-publish.yml
@@ -14,24 +14,21 @@ concurrency:
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2
     - name: Setup .NET Core
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: 8.x
-    - name: Setup DocFX
-      uses: crazy-max/ghaction-chocolatey@v3
-      with:
-        args: install docfx
     - name: Install dependencies
       run: dotnet restore
       working-directory: src/Textkernel.Tx.SDK
     # generate the DocFX docs into the /docfx/_site folder
-    - name: DocFX Build
-      working-directory: docfx
-      run: docfx docfx.json
+    - name: Build Documentation
+      uses: nunit/docfx-action@v4.1.0
+      with:
+        args: docfx/docfx.json
       continue-on-error: false
     # upload the generated docs into an artifact that can be used by the job below
     - name: Upload Artifacts