Improve SEO, add llms.txt, and modernize CI pipeline

- Add meta descriptions to all 122 documentation pages for SEO
- Add robots.txt and styled sitemap.xml for search engine discoverability
- Add auto-generated llms.txt and llms-full.txt for LLM consumption
- Add OpenGraph and Twitter meta tags via overrides/main.html
- Update copyright year to 2026 and improve site description
- Upgrade GitHub Actions (checkout v6, setup-python v6)
- Replace muffet link checker with lychee-action for simpler CI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: christophdb

.github/workflows/mkdocs-deploy.yml

@@ -1,4 +1,4 @@
-name: Deploy mkdocs to github pages
+name: Deploy admin.seatable.com (mkdocs material with github pages)
 
 on:
   push:
@@ -8,56 +8,50 @@ on:
       branches:
           - main
 
-env:
-  GO_VERSION: 1.24.1
-  MUFFET_VERSION: v2.10.7
+permissions:
+  contents: write
 
 jobs:
   check-links:
     name: Check links
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
-      - uses: actions/setup-go@v2
+        uses: actions/checkout@v6
+
+      - name: Check links in markdown files
+        uses: lycheeverse/lychee-action@v2
         with:
-          go-version: ${{ env.GO_VERSION }}
-      - name: Start development server
-        run: ./preview.sh
-      - name: Add $GOPATH/bin to $PATH
-        run: |
-          echo "$(go env GOPATH)/bin" >> "$GITHUB_PATH"
-      - name: Install muffet
-        run: go install github.com/raviqqe/muffet/v2@${MUFFET_VERSION}
-      - name: Check links
-        run: muffet -t60 -c10 -f -i 'http://127*' -i 'http://localhost' http://127.0.0.1:8000
+          args: "--verbose --no-progress --root-dir docs --exclude 'http://127*' --exclude 'http://localhost' './docs/**/*.md'"
+          fail: true
+
   deploy:
     runs-on: ubuntu-latest
     needs:
       - check-links
     if: github.ref == 'refs/heads/main'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v6
         with:
           python-version: 3.x
 
-      - name: install
+      - name: Install dependencies
         run: pip install -r requirements.txt
 
-      - name: version
-        run: mkdocs --version
+      - name: Generate llms.txt and llms-full.txt
+        run: python3 scripts/generate_llms_txt.py
 
-      - name: build
+      - name: Build with mkdocs (strict mode)
         run: mkdocs build --verbose --strict
         env:
           MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.MKDOCS_GIT_COMMITTERS_APIKEY }}
           CI: true
 
-      - name: gh-deploy
+      - name: Deploy to GitHub Pages
         run: mkdocs gh-deploy --force
         env:
           MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.MKDOCS_GIT_COMMITTERS_APIKEY }}

.gitignore

@@ -2,4 +2,8 @@
 /site/
 /.idea
 .cache
-__pycache__/
+__pycache__/
+
+# Generated at build time by scripts/generate_llms_txt.py
+docs/llms.txt
+docs/llms-full.txt