Merge remote-tracking branch 'origin/main' into chore/ai-crawler-ruleschore/ai-crawler-rules

3 files changed, 52 insertions, 0 deletions

diff --git a/docs/api/docfx.json b/docs/api/docfx.json
new file mode 100644
index 0000000..e10a9b0
--- /dev/null
+++ b/docs/api/docfx.json
@@ -0,0 +1,26 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../../apps/api",
+          "files": ["Progmaweb.Api.csproj"]
+        }
+      ],
+      "dest": "reference",
+      "includePrivateMembers": true
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": ["index.md", "toc.yml", "reference/**/*.yml"]
+      }
+    ],
+    "dest": "_site",
+    "globalMetadata": {
+      "_appTitle": "Progmaweb API",
+      "_enableSearch": false
+    }
+  }
+}
diff --git a/docs/api/index.md b/docs/api/index.md
new file mode 100644
index 0000000..868fff1
--- /dev/null
+++ b/docs/api/index.md
@@ -0,0 +1,19 @@
+<!--
+SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com>
+SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1
+-->
+
+# Progmaweb API
+
+Reference documentation of the Progmaweb account service, generated by DocFX
+from the XML documentation comments of `apps/api`.
+
+The service is an application, not a library, so most of its types are
+internal. The reference includes them: it documents the code for the people
+who maintain it.
+
+Build it from the repository root:
+
+```sh
+docfx docs/api/docfx.json --warningsAsErrors
+```
diff --git a/docs/api/toc.yml b/docs/api/toc.yml
new file mode 100644
index 0000000..cf49dc1
--- /dev/null
+++ b/docs/api/toc.yml
@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1
+
+- name: Overview
+  href: index.md
+- name: Reference
+  href: reference/