Skip to content

Serve workbook and controls matrix PDFs as static files - #23

Merged
cner-smith merged 1 commit into
mainfrom
claude/funny-cerf-zchjxi
Sep 22, 2026
Merged

cner-smith merged 1 commit into
mainfrom
claude/funny-cerf-zchjxi

Conversation

@cner-smith

Copy link
Copy Markdown
Collaborator

Pull Request

What does this change?

Moves the three workbook/controls-matrix PDFs out of the Starlight content collection and into the site's static assets folder, then links them from the Tools page.

  • site/src/content/docs/docs/tools/*.pdf → site/public/docs/tools/*.pdf
  • Adds a Downloads section to site/src/content/docs/docs/tools/index.md with a direct link to each PDF.

Why?

The PDFs were committed under site/src/content/docs/docs/tools/, which is an Astro content collection. Astro only renders Markdown and MDX files from a content collection and ignores everything else, so the PDFs were never emitted into site/dist and never deployed. Requesting their URL on the Pages site returned a 404.

Astro copies site/public/ into the build output verbatim, so files placed there are served as-is. Verified locally with npm run build: all three PDFs now appear in site/dist/docs/tools/, and the Tools page renders the three links with the correct /playbook base prefix.

Once merged, the files are reachable at:

  • https://open-sovereignty-lab.github.io/playbook/docs/tools/Data_Sovereignty_Workbook.pdf
  • https://open-sovereignty-lab.github.io/playbook/docs/tools/Data_Sovereignty_Workbook_with_Controls_Matrix.pdf
  • https://open-sovereignty-lab.github.io/playbook/docs/tools/Tribal_Data_Sovereignty_Protection_Controls_Matrix.pdf

Type of change

  • New content (case study, implementation guide, policy template, etc.)
  • New code (Terraform, CloudFormation, scripts, etc.)
  • New legal template
  • Correction or update to existing content
  • Documentation or formatting fix
  • Other (describe above)

Checklist

  • All factual claims are sourced and citations are included — no new factual claims; file moves and links only
  • Content about a specific Tribal Nation is sourced from that nation's own materials or direct consultation — n/a, no new content
  • Any pricing or platform-specific details include an "as of [date]" qualifier — n/a
  • No vendor promotional content presented as neutral guidance — n/a
  • If adding code: it has been tested and reviewed for security issues — no code added; site build verified locally
  • CHANGELOG.md has been updated — left to release-please, which generates the changelog from commit history

Notes for reviewers

The PDF binaries are unchanged; git records all three as pure renames. The only content edit is the new Downloads section on the Tools page.

Links use the absolute /playbook/... form because astro.config.mjs sets base: '/playbook'. Relative links would break on the deployed site.

🤖 Generated with Claude Code

Move the three PDFs from the Starlight content collection (where Astro
ignores non-Markdown files, so they never reached the build output and
returned 404 on the Pages site) into site/public/docs/tools/, which Astro
copies verbatim into the deployed site. Add a Downloads section on the
Tools page linking to each file.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013t2mcBANp4xHzmntdTfEEM
@cner-smith
cner-smith merged commit 7dffc8d into main Sep 22, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants