Add missing docs check

Author: DanielBadura

.github/workflows/docs-check.yml

@@ -0,0 +1,48 @@
+# https://help.github.com/en/categories/automating-your-workflow-with-github-actions
+
+name: "Check Docs"
+
+on:
+    pull_request:
+    push:
+        branches:
+            - "[0-9]+.[0-9]+.x"
+
+jobs:
+    checkdocs:
+        name: "Check Docs"
+
+        runs-on: ${{ matrix.operating-system }}
+
+        strategy:
+            matrix:
+                dependencies:
+                    - "locked"
+                php-version:
+                    - "8.5"
+                operating-system:
+                    - "ubuntu-latest"
+
+        steps:
+            - name: "Checkout"
+              uses: actions/checkout@v7
+
+            - name: "Install PHP"
+              uses: "shivammathur/setup-php@2.37.2"
+              with:
+                  coverage: none
+                  php-version: "${{ matrix.php-version }}"
+                  ini-values: memory_limit=-1, opcache.enable_cli=1
+
+            - uses: ramsey/composer-install@4.0.0
+              with:
+                dependency-versions: ${{ matrix.dependencies }}
+
+            - name: "extract php code"
+              run: "bin/docs-extract-php-code"
+
+            - name: "lint php"
+              run: "php -l docs_php/*.php"
+
+            - name: "docs code style"
+              run: "vendor/bin/phpcbf docs_php --exclude=SlevomatCodingStandard.TypeHints.DeclareStrictTypes,SlevomatCodingStandard.ControlStructures.EarlyExit"

.gitignore

@@ -7,3 +7,4 @@ phpstan.neon
 infection.log
 infection.html
 .phpbench/
+docs_php/

Makefile

@@ -44,5 +44,27 @@ benchmark-diff-test: vendor
 	vendor/bin/phpbench run tests/Benchmark --revs=1 --report=diff --progress=none --ref=base
 
 
+.PHONY: docs
+docs: docs-extract-php docs-php-lint docs-phpcs docs-inject-php                  ## check and format docs code
+
+.PHONY: docs-extract-php
+docs-extract-php: vendor
+	bin/docs-extract-php-code
+
+.PHONY: docs-inject-php
+docs-inject-php: vendor
+	bin/docs-inject-php-code
+
+.PHONY: docs-format
+docs-format: docs-phpcs docs-inject-php                                         ## format docs
+
+.PHONY: docs-php-lint
+docs-php-lint: docs-extract-php                                                 ## lint docs code
+	php -l docs_php/*.php | grep -E 'Parse error|Fatal error' || true
+
+.PHONY: docs-phpcs
+docs-phpcs: docs-extract-php
+	vendor/bin/phpcbf docs_php --exclude=SlevomatCodingStandard.TypeHints.DeclareStrictTypes,SlevomatCodingStandard.ControlStructures.EarlyExit || true
+
 .PHONY: dev
 dev: static test                                                                ## run dev tools