Add GitHub Actions workflows for quality checks

- Add markdown linting workflow that runs on PRs and blocks merging if issues found
- Add dead link checker with weekly schedule and PR triggers
- Add MkDocs build validation to ensure documentation builds correctly
- Configure markdownlint rules appropriate for MkDocs Material sites

These workflows enforce documentation quality standards and catch broken links automatically.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ironicbadger

.github/workflows/check-links.yml

@@ -0,0 +1,66 @@
+name: Check for Dead Links
+
+on:
+  schedule:
+    # Run every Sunday at 2 AM UTC
+    - cron: '0 2 * * 0'
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - '**.md'
+      - 'mkdocs.yml'
+
+jobs:
+  link-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Link Checker
+        uses: lycheeverse/lychee-action@v2
+        with:
+          # Check all markdown files
+          args: >
+            --verbose
+            --no-progress
+            --accept=200,201,202,203,204,301,302,303,307,308
+            --timeout 20
+            --max-retries 3
+            --user-agent "Mozilla/5.0 (compatible; pms-wiki-link-checker)"
+            --exclude-private
+            --exclude "^(?i:mailto)"
+            --exclude "^(?i:javascript)"
+            --exclude "github.com/.*/edit/"
+            --exclude "github.com/.*/blob/"
+            --exclude "localhost"
+            --exclude "127.0.0.1"
+            --exclude "example.com"
+            --exclude "example.org"
+            --exclude "plausible.ktz.cloud"
+            --exclude "techhub.social"
+            --exclude-path node_modules/
+            --exclude-path .git/
+            '**/*.md'
+          fail: true
+          format: markdown
+          output: ./lychee-report.md
+          jobSummary: true
+          
+      - name: Upload link check report
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: link-check-report
+          path: lychee-report.md
+          
+      - name: Create issue from failed link check
+        if: failure() && github.event_name == 'schedule'
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: "Broken links detected in documentation"
+          content-filepath: ./lychee-report.md
+          labels: |
+            documentation
+            broken-links
+            automated

.github/workflows/lint.yml

@@ -0,0 +1,39 @@
+name: Markdown Linting
+
+on:
+  pull_request:
+    paths:
+      - '**.md'
+      - '.markdownlint.yml'
+      - '.github/workflows/lint.yml'
+  push:
+    branches:
+      - main
+    paths:
+      - '**.md'
+      - '.markdownlint.yml'
+      - '.github/workflows/lint.yml'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          
+      - name: Install markdownlint-cli2
+        run: npm install -g markdownlint-cli2
+        
+      - name: Run markdownlint
+        run: markdownlint-cli2 "**/*.md" "#node_modules"
+        
+      - name: Check for markdown issues
+        if: failure()
+        run: |
+          echo "::error::Markdown linting failed. Please fix the issues above before merging."
+          exit 1

.github/workflows/validate-build.yml

@@ -0,0 +1,58 @@
+name: Validate MkDocs Build
+
+on:
+  pull_request:
+    paths:
+      - 'docs/**'
+      - 'overrides/**'
+      - 'mkdocs.yml'
+      - 'requirements.txt'
+      - '.github/workflows/validate-build.yml'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+          
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt', '**/mkdocs.yml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+            
+      - name: Install MkDocs and dependencies
+        run: |
+          pip install --upgrade pip
+          pip install mkdocs-material
+          pip install mkdocs-material[imaging]
+          pip install mkdocs-minify-plugin
+          pip install mkdocs-git-revision-date-plugin
+          pip install mkdocs-material-plausible-plugin
+          pip install pillow cairosvg
+          
+      - name: Build MkDocs site
+        run: mkdocs build --strict --verbose
+        
+      - name: Check for build warnings
+        run: |
+          mkdocs build --strict 2>&1 | tee build.log
+          if grep -q "WARNING" build.log; then
+            echo "::warning::Build completed with warnings. Please review the output above."
+          fi
+          
+      - name: Upload build artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: mkdocs-build-site
+          path: site/
+          retention-days: 7

.markdownlint.yml

@@ -0,0 +1,88 @@
+# Markdownlint configuration for PMS Wiki
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+
+# Default state for all rules
+default: true
+
+# Line length
+MD013:
+  # Allow long lines for tables and code blocks
+  line_length: 120
+  tables: false
+  code_blocks: false
+  
+# Inline HTML - disabled as MkDocs Material uses HTML
+MD033:
+  allowed_elements:
+    - div
+    - span
+    - br
+    - p
+    - a
+    - img
+    - details
+    - summary
+    - kbd
+    - sup
+    - sub
+    - figure
+    - figcaption
+
+# First line in file should be a top-level heading
+MD041: false
+
+# Duplicate heading - disabled for docs that may repeat headings
+MD024: false
+
+# Multiple headings with the same content - disabled for consistency
+MD025: false
+
+# Trailing punctuation in heading
+MD026:
+  punctuation: ".,;:!"
+
+# Lists should be surrounded by blank lines
+MD032: true
+
+# Code block style
+MD046:
+  style: fenced
+
+# Emphasis style
+MD049:
+  style: underscore
+
+# Strong style  
+MD050:
+  style: asterisk
+
+# Link and image style
+MD054:
+  link_image_style: collapsed
+  link_image_collapse_single_space: true
+
+# Table pipe style
+MD055:
+  style: leading_and_trailing
+
+# Table row style
+MD056: true
+
+# Dollar signs used before commands without showing output
+MD014: false
+
+# No bare URLs - disabled as some docs use them intentionally
+MD034: false
+
+# Horizontal rules style
+MD035:
+  style: "---"
+
+# No inline HTML - disabled for MkDocs Material
+MD033: false
+
+# First line should be a heading - disabled for included files
+MD041: false
+
+# Require code fence language - disabled as not always needed
+MD040: false