Files
beads/.github/workflows/deploy-docs.yml
Steve Yegge 584608a14e feat: add llms.txt standard support for AI agent discoverability (#784)
Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml
from joyshmitz's PR. Fixed workflow to trigger on main branch instead of
docs/docusaurus-site.

Features:
- Docusaurus documentation site with llms.txt support
- Environment-variable driven config (defaults to steveyegge org)
- Automated llms-full.txt generation from docs
- GitHub Pages deployment workflow

Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com>

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew
2025-12-30 18:27:50 -08:00

95 lines
2.2 KiB
YAML

name: Deploy Documentation
on:
push:
branches:
- main
paths:
- 'website/**'
- 'scripts/generate-llms-full.sh'
workflow_dispatch:
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
contents: read
pages: write
id-token: write
# Allow only one concurrent deployment
concurrency:
group: "pages"
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: 20
cache: 'npm'
cache-dependency-path: website/package-lock.json
- name: Install dependencies
working-directory: website
run: npm ci
- name: Generate llms-full.txt
run: ./scripts/generate-llms-full.sh
- name: Build website
working-directory: website
run: npm run build
- name: Check internal links
uses: lycheeverse/lychee-action@v2
with:
args: |
--verbose
--no-progress
--offline
--include-fragments
--timeout 30
--exclude-path 'website/build/search/**'
website/build
fail: true
- name: Check external links (non-blocking)
uses: lycheeverse/lychee-action@v2
continue-on-error: true
with:
cache: true
args: |
--verbose
--no-progress
--timeout 30
--scheme https
--scheme http
--exclude 'localhost'
--exclude '127.0.0.1'
--exclude 'tree/main'
--exclude 'example.com'
--exclude 'mailto:'
--exclude-path 'website/build/search/**'
website/build
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: website/build
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4