TASK: Render API docs (again)

.doctum.php

@@ -0,0 +1,28 @@
+<?php
+declare(strict_types=1);
+
+use Doctum\Doctum;
+use Doctum\RemoteRepository\GitHubRemoteRepository;
+use Symfony\Component\Finder\Finder;
+
+$iterator = Finder::create()
+    ->files()
+    ->name('*.php')
+    ->path('/Classes/')
+    ->in(__DIR__);
+
+return new Doctum($iterator, [
+    'title' => 'Neos CMS',
+    'base_url' => 'https://neos.github.io/',
+    'favicon' => 'https://www.neos.io/favicon-32x32.png',
+    'language' => 'en',
+    'remote_repository' => new GitHubRemoteRepository('neos/neos-development-collection', __DIR__),
+    'footer_link' => [
+        'href' => 'https://www.neos.io',
+        'rel' => 'noreferrer noopener',
+        'target' => '_blank',
+        'before_text' => 'Learn more about the',
+        'link_text' => 'Neos Content Application Platform',
+        'after_text' => 'if you like!',
+    ]
+]);

.github/workflows/doctum.yml

@@ -0,0 +1,49 @@
+name: Build API documentation
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ '[0-9]+.[0-9]' ]
+
+jobs:
+  build-api-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Build API documentation
+        uses: sudo-bot/action-doctum@v5
+        with:
+          config-file: .doctum.php
+          method: "update"
+          # use of --only-version fixes branch name in "View source" links to GitHub
+          cli-args: "--output-format=github --no-ansi --no-progress --ignore-parse-errors --only-version=${{ github.ref_name }}"
+
+      - name: Check out documentation site
+        uses: actions/checkout@v3
+        with:
+          repository: neos/neos.github.io
+          path: docs-site
+
+      - name: Move rendered docs to site
+        run: |
+          rm -rf docs-site/neos/${{ github.ref_name }}
+          mkdir -p docs-site/neos/${{ github.ref_name }}
+          mv build/* docs-site/neos/${{ github.ref_name }}/
+
+      - name: Commit update
+        run: |
+          cd docs-site
+          git config --local --unset-all "http.https://github.com/.extraheader"
+          git config --global user.email "[email protected]"
+          git config --global user.name "Neos Bot"
+          git add .
+          git commit -m "TASK: Update API docs from ${{ github.ref_name }}"
+
+      - name: Push to git
+        uses: ad-m/[email protected]
+        with:
+          github_token: ${{ secrets.NEOS_BOT_TOKEN }}
+          repository: neos/neos.github.io
+          directory: docs-site
+          branch: main