- beads-release formula: drop the snapshot-docs step (ran the deleted scripts/snapshot-release-docs.sh on the critical needs-chain); stamp- changelog now needs update-vendorhash - update-versions.sh: remove the mangled --skip-docs/docs-snapshot logic and garbled usage text left by mid-line deletions - pre-push hook: drop the snapshot-script remediation hint - release.yml: collapse the prerelease branch; BEADS_REQUIRE_RELEASE_DOCS has no consumer since check-docs-version.sh was deleted - RELEASING.md / scripts/docs.md: describe the current pipeline (no --versioned, no website/ outputs, no check-docs-version.sh) - docs-mintlify.yml: paths filter now includes engdocs/** and the curated root markdown files the docsync guard validates - docs-render-check.sh: pin mint@4.2.687, fail closed when mint dies without producing a broken-links report, parse report lines only, drop dead extract_page_links(), fix the stale jq requirement; mint.sh pins the same version - nightly.yml: remove the deleted website measurement suite option - CODEOWNERS: init-safety ADR gate follows the file to engdocs/adr/ - beads-docs skill: align with settled decision 6 — no pointer stubs, moved pages get docs.json redirects; bd's printed paths are fixed at the source - CHANGELOG (edited line), FEDERATION-SETUP, README, examples, oracle-a, .buildflags, gh-issue-to-pr formula: retarget moved-file references; anchor the build/ gitignore pattern
65 lines
1.9 KiB
YAML
65 lines
1.9 KiB
YAML
name: Docs (Mintlify) checks
|
|
|
|
on:
|
|
pull_request:
|
|
types: [opened, synchronize, reopened, ready_for_review]
|
|
paths:
|
|
# The docsync guard also validates engdocs/** and the curated root
|
|
# markdown files (rootDocFiles in test/docsync/docsync_test.go) — keep
|
|
# this filter in sync with that list, or a docs-breaking PR merges
|
|
# green and turns main red at the full test run.
|
|
- 'docs/**'
|
|
- 'engdocs/**'
|
|
- 'test/docsync/**'
|
|
- 'mint.sh'
|
|
- 'README.md'
|
|
- 'AGENTS.md'
|
|
- 'AGENT_INSTRUCTIONS.md'
|
|
- 'CONTRIBUTING.md'
|
|
- 'CLAUDE.md'
|
|
- 'RELEASING.md'
|
|
- 'PR_MAINTAINER_GUIDELINES.md'
|
|
- '.github/scripts/docs-render-check.sh'
|
|
- '.github/workflows/docs-mintlify.yml'
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: docs-mintlify-${{ github.event.pull_request.number }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
docsync:
|
|
name: Docs nav/link sync (docsync guard)
|
|
runs-on: ubuntu-latest
|
|
if: github.event.pull_request.draft == false
|
|
steps:
|
|
- uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v6
|
|
|
|
- name: Set up Go
|
|
uses: actions/setup-go@924ae3a1cded613372ab5595356fb5720e22ba16 # v6
|
|
with:
|
|
go-version-file: 'go.mod'
|
|
|
|
- name: Run docsync guard
|
|
run: go test -tags=gms_pure_go ./test/docsync
|
|
|
|
broken-links:
|
|
name: Mintlify broken-links (baseline-aware)
|
|
runs-on: ubuntu-latest
|
|
if: github.event.pull_request.draft == false
|
|
steps:
|
|
- uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v6
|
|
with:
|
|
fetch-depth: 0
|
|
|
|
- name: Setup Node.js
|
|
uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
|
|
with:
|
|
node-version: 22
|
|
|
|
- name: Run baseline-aware broken-link check
|
|
env:
|
|
BASE_REF: origin/${{ github.base_ref }}
|
|
run: .github/scripts/docs-render-check.sh "$BASE_REF"
|