Setup documentation workflow (#72)

.github/workflows/documentation.yml

@@ -0,0 +1,20 @@
+name: "Documentation"
+
+on:
+  pull_request:
+    branches:
+      - "*.x"
+    paths:
+      - ".github/workflows/documentation.yml"
+      - "docs/**"
+  push:
+    branches:
+      - "*.x"
+    paths:
+      - ".github/workflows/documentation.yml"
+      - "docs/**"
+
+jobs:
+  documentation:
+    name: "Documentation"
+    uses: "doctrine/.github/.github/workflows/documentation.yml@5.1.0"

.gitignore

@@ -4,3 +4,6 @@
 /phpcs.xml
 /.phpcs-cache
 /.phpunit.cache
+
+# phpDocumentor/guides output directory
+/output

composer.json

@@ -42,6 +42,7 @@
     },
     "require-dev": {
         "doctrine/coding-standard": "^12",
+        "phpdocumentor/guides-cli": "^1.4",
         "phpstan/phpstan": "^1.8.8",
         "phpunit/phpunit": "^10.5",
         "vimeo/psalm": "^5.24"

docs/en/sidebar.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 .. toctree::
     :depth: 3