Allow running lint-docs manually.

.github/workflows/lint-docs.yaml

@@ -0,0 +1,39 @@
+name: build-docs
+on:
+  workflow_dispatch:
+
+  pull_request:
+    branches:
+      - main
+
+  jobs:
+    build-docs:
+      permissions:
+        contents: read
+      name: Build Docs
+      uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-pr.yml@main
+      with:
+        init-lenient: false
+        init-fail-on-error: true
+
+    lint-docs:
+      permissions:
+        contents: read
+      needs:
+        - build-docs
+      steps:
+        - uses: actions/download-artifact@v4
+          with:
+            name: ${{ needs.build-docs.outputs.artifact-name }}
+            github_token: ${{ secrets.GITHUB_TOKEN }}
+        - uses: actions/setup-python@v5
+          with:
+            python-version: '3.11'
+        - name: Install antsibull-docs
+          run: pip install antsibull-docs
+        - name: Lint Docs
+          run: |
+            antsibull-docs lint-collection-docs \
+            --plugin-docs \
+            --validate-collection-refs=all \
+            --disallow-unknown-collection-refs .