From 5631303cc69e76d9e5eb07bd51d6c13201d0a2af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andreas=20M=C3=BCller?= <webmaster@am-wd.de>
Date: Mon, 12 Jan 2026 20:31:56 +0100
Subject: [PATCH] Added docs

---
 .gitea/workflows/docs-build.yml     |  66 ++++++++++++++++++++++++++++
 .gitea/workflows/release-build.yml  |   5 ++-
 docs/docfx.json                     |  65 +++++++++++++++++++++++++++
 docs/images/favicon.ico             | Bin 0 -> 15086 bytes
 docs/images/logo.svg                |   1 +
 docs/index.md                       |  18 ++++++++
 docs/templates/amwd/public/main.css |   3 ++
 docs/toc.yml                        |   6 +++
 8 files changed, 163 insertions(+), 1 deletion(-)
 create mode 100644 .gitea/workflows/docs-build.yml
 create mode 100644 docs/docfx.json
 create mode 100644 docs/images/favicon.ico
 create mode 100644 docs/images/logo.svg
 create mode 100644 docs/index.md
 create mode 100644 docs/templates/amwd/public/main.css
 create mode 100644 docs/toc.yml

diff --git a/.gitea/workflows/docs-build.yml b/.gitea/workflows/docs-build.yml
new file mode 100644
index 0000000..8601921
--- /dev/null
+++ b/.gitea/workflows/docs-build.yml
@@ -0,0 +1,66 @@
+name: Documentation Build
+
+on:
+  push:
+    branches:
+      - 'main'
+
+env:
+  TZ: 'Europe/Berlin'
+  LANG: 'de'
+  CONFIGURATION: 'Release'
+  GITEA_SERVER_URL: ${{ gitea.server_url }}
+
+jobs:
+  build-test-deploy:
+    runs-on: server-runner
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Checkout repository code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup dotnet
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: 10.x
+          cache: false
+
+      - name: Restore dependencies
+        run: |
+          set -ex
+          dotnet restore -v q
+          echo "CI_SERVER_HOST=${GITEA_SERVER_URL#https://}" >> "$GITEA_ENV"
+
+      - name: Setup tools
+        run: |
+          set -ex
+          dotnet tool install dotnet-reportgenerator-globaltool --tool-path /dotnet-tools
+          dotnet tool install docfx --tool-path /dotnet-tools
+
+      - name: Build solution
+        run: |
+          set -ex
+          shopt -s globstar
+          mkdir /artifacts
+          dotnet build -c ${CONFIGURATION} --no-restore --nologo
+          mv ./**/*.nupkg  /artifacts/ || true
+          mv ./**/*.snupkg /artifacts/ || true
+
+      - name: Test solution
+        run: |
+          set -ex
+          dotnet test -c ${CONFIGURATION} --no-build --nologo
+
+      - name: Publish documentation
+        env:
+          DOCFX_SOURCE_REPOSITORY_URL: 'https://gitea.am-wd.de/am-wd/common'
+        run: |
+          set -ex
+          /dotnet-tools/docfx metadata docs/docfx.json
+          /dotnet-tools/docfx build docs/docfx.json
+          tar -C "${{ gitea.workspace }}/docs/_site" -czf "/artifacts/docs.tar.gz" .
+          curl -sSL --no-progress-meter --user "${{ secrets.DOCS_DEPLOY_USER }}:${{ secrets.DOCS_DEPLOY_PASS }}" -F docs=common -F dump=@/artifacts/docs.tar.gz "${{ vars.DOCS_DEPLOY_URL }}"
\ No newline at end of file
diff --git a/.gitea/workflows/release-build.yml b/.gitea/workflows/release-build.yml
index 5858993..53269ca 100644
--- a/.gitea/workflows/release-build.yml
+++ b/.gitea/workflows/release-build.yml
@@ -15,6 +15,9 @@ env:
 jobs:
   build-test-deploy:
     runs-on: ubuntu
+    defaults:
+      run:
+        shell: bash
     steps:
       - name: Checkout repository code
         uses: actions/checkout@v6
@@ -58,4 +61,4 @@ jobs:
       - name: Publish packages
         run: |
           set -ex
-          dotnet nuget push -k "${{ secrets.BAGET_APIKEY }}" -s https://nuget.am-wd.de/v3/index.json --skip-duplicate /artifacts/*.nupkg
+          dotnet nuget push -k "${{ secrets.BAGET_APIKEY }}" -s https://nuget.am-wd.de/v3/index.json --skip-duplicate /artifacts/*.nupkg
\ No newline at end of file
diff --git a/docs/docfx.json b/docs/docfx.json
new file mode 100644
index 0000000..97a49dd
--- /dev/null
+++ b/docs/docfx.json
@@ -0,0 +1,65 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../",
+          "files": [
+            "src/AMWD.Common/bin/Release/netstandard2.0/amwd-common.dll",
+            "src/AMWD.Common.AspNetCore/bin/Release/net8.0/amwd-common-aspnetcore.dll",
+            "src/AMWD.Common.EntityFrameworkCore/bin/Release/net8.0/amwd-common-efcore.dll",
+            "src/AMWD.Common.MessagePack/bin/Release/netstandard2.0/amwd-common-msgpack.dll",
+            "src/AMWD.Common.Test/bin/Release/netstandard2.0/amwd-common-test.dll"
+          ]
+        }
+      ],
+      "dest": "api",
+      "outputFormat": "apiPage"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [ "**/*.{md,yml}" ],
+        "exclude": [ "_site/**", "obj/**" ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [ "images/**" ],
+        "exclude": [ "_site/**", "obj/**" ]
+      }
+    ],
+    "output": "_site",
+    "template": [ "default", "modern", "templates/amwd" ],
+    "postProcessors": ["ExtractSearchIndex"],
+    "globalMetadata": {
+      "_appName": "AM.WD Common",
+      "_appTitle": "A collection of commonly used extensions, etc.",
+      "_appFooter": "<span>&copy; AM.WD &mdash; Docs generated using <a href=\"https://dotnet.github.io/docfx\" target=\"_blank\">docfx</a>.</span>",
+      "_appLogoPath": "images/logo.svg",
+      "_appFaviconPath": "images/favicon.ico",
+      "_disableBreadcrumb": true,
+      "_disableContribution": true,
+      "_enableSearch": true,
+      "_enableNewTab": true,
+      "pdf": false
+    },
+    "markdownEngineName": "markdig",
+    "markdownEngineProperties": {
+      "alerts": {
+        "TODO": "alert alert-secondary"
+      }
+    },
+    "sitemap": {
+      "baseUrl": "https://docs.am-wd.de/common",
+      "priority": 0.5,
+      "changefreq": "weekly"
+    },
+    "noLangKeyword": false,
+    "keepFileLink": false,
+    "cleanupCacheHistory": false,
+    "disableGitFeatures": true
+  }
+}
\ No newline at end of file
diff --git a/docs/images/favicon.ico b/docs/images/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..d383eacd5b26879f542f2b347c858edadc900e43
GIT binary patch
literal 15086
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
bf7zTy<({`9H)=z2pW8p9eqj!C;eq!*;^9sq

literal 0
HcmV?d00001

diff --git a/docs/images/logo.svg b/docs/images/logo.svg
new file mode 100644
index 0000000..70920a1
--- /dev/null
+++ b/docs/images/logo.svg
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg width="35" height="35" viewBox="0 0 384 384" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><circle cx="192" cy="192" r="172.8" style="fill:#333;"/><g><path d="M146.936,255.996l0,-19.248l-40.376,-0l-13.045,19.248l-39.755,0l78.475,-116.086c5.384,-7.937 12.769,-11.906 22.156,-11.906c7.04,-0 13.148,2.48 18.324,7.441c5.177,4.961 7.765,10.815 7.765,17.562l0,45.442l-33.544,0l0,-21.431l-19.049,27.781l52.593,0l0,51.197l-33.544,0Z" style="fill:#09f;fill-rule:nonzero;"/><path d="M303.881,255.996l-0,-78.978c-4.148,9.128 -7.531,16.536 -10.151,22.225c-9.168,19.447 -18.118,29.17 -26.85,29.17c-8.623,0 -17.518,-9.657 -26.687,-28.972c-3.492,-7.408 -6.93,-14.882 -10.314,-22.423l0,78.978l-26.359,0l0,-102.989c0,-6.879 2.019,-12.766 6.058,-17.661c4.038,-4.895 8.895,-7.342 14.571,-7.342c9.714,-0 19.974,11.112 30.779,33.337c3.93,8.599 7.914,17.198 11.952,25.797c3.384,-7.408 6.822,-14.816 10.314,-22.225c5.239,-11.112 9.987,-19.447 14.244,-25.003c6.112,-7.937 12.17,-11.906 18.173,-11.906c5.676,-0 10.533,2.447 14.571,7.342c4.039,4.895 6.058,10.782 6.058,17.661l0,102.989l-26.359,0Z" style="fill:#09f;fill-rule:nonzero;"/></g></svg>
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..c4d64ab
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,18 @@
+---
+_layout: landing
+---
+
+# AM.WD Common
+
+Over many years, I copied many lines of code over and over again.    
+So I deciced it was time to change something!
+
+I started my own NuGet package and it grew over time.
+
+Now I have my own packages with many extensions and "improvements" for my everyday use.
+
+![https://nuget.am-wd.de/packages/amwd.common/](https://docs.am-wd.de/nuget.php?package=AMWD.Common)
+![https://nuget.am-wd.de/packages/amwd.common.aspnetcore/](https://docs.am-wd.de/nuget.php?package=AMWD.Common.AspNetCore)
+![https://nuget.am-wd.de/packages/amwd.common.entityframeworkcore/](https://docs.am-wd.de/nuget.php?package=AMWD.Common.EntityFrameworkCore)
+![https://nuget.am-wd.de/packages/amwd.common.messagepack/](https://docs.am-wd.de/nuget.php?package=AMWD.Common.MessagePack)
+![https://nuget.am-wd.de/packages/amwd.common.test/](https://docs.am-wd.de/nuget.php?package=AMWD.Common.Test)
\ No newline at end of file
diff --git a/docs/templates/amwd/public/main.css b/docs/templates/amwd/public/main.css
new file mode 100644
index 0000000..057f8d0
--- /dev/null
+++ b/docs/templates/amwd/public/main.css
@@ -0,0 +1,3 @@
+#logo {
+	margin-right: 8px;
+}
\ No newline at end of file
diff --git a/docs/toc.yml b/docs/toc.yml
new file mode 100644
index 0000000..02dd0a3
--- /dev/null
+++ b/docs/toc.yml
@@ -0,0 +1,6 @@
+- name: API
+  href: api/
+- name: Git
+  href: https://gitea.am-wd.de/am-wd/common
+- name: NuGet
+  href: https://nuget.am-wd.de/?q=AMWD.Common