Repository navigation
Comparing changes
Open a pull request
base repository: sqlc-dev/docs
base: main
head repository: sqlc-dev/docs
compare: claude/coding-session-p6butr
- 7 commits
- 34 files changed
- 1 contributor
Commits on Aug 26, 2026
-
Build the docs site: Fumadocs static export fed by sqlc-dev/sqlc docs/
Scaffold a Fumadocs (Next.js static export) site mounted at the domain root, plus everything around it: - scripts/ingest.mjs: checks out sqlc docs (or takes --src), derives frontmatter titles from each page's # heading, converts toc.yaml into the sidebar meta.json (sections as separators, unlisted pages kept out of the sidebar), and fails loudly on contract drift - pages stay .md so fumadocs-mdx compiles them as Markdown, not MDX; literal {...} and <...> in prose render as written - lib/remark-github-alerts.ts maps GitHub alert blockquotes to Callouts; lib/relative-link.tsx resolves relative .md links (bare ones included) to routes at render time - versioned builds via NEXT_PUBLIC_BASE_PATH with noindex and a version switcher driven by a runtime-fetched /versions.json - scripts/redirects.mjs emits meta-refresh stubs for the legacy Read the Docs /en/latest/*.html URLs and the old rediraffe rule - workflows: CI build on PRs, latest deploy on repository_dispatch/cron, tag deploys that sync to a version prefix and append versions.json Generated output (content/, out/, .source/) is never committed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxCConfiguration menu - View commit details
-
Copy full SHA for 361be00 - Browse repository at this point
Copy the full SHA 361be00View commit details -
Keep the Read the Docs URL scheme as canonical
Nothing changes for existing links — they serve content directly instead of redirecting: - the latest build mounts at /en/latest (default basePath), versioned builds at /en/vX.Y.Z, matching RTD's tag URLs - page routes carry the .html suffix via a custom loader url, so every internal link, sidebar entry, and search result points at the exact legacy URL (/en/latest/howto/select.html) and the exported file is the page itself — no edge rewrite rules needed - scripts/fix-html-ext.mjs renames Next's <route>.html.html exports and moves the per-segment prefetch dirs (which squat on the page's own path) to out-segments/; object storage holds both key shapes, and filesystem hosts fall back to the full-page RSC payload - redirects shrink to: / and /en/ → /en/latest/, plus the carried-over upload → push rule, all generated into out-root/ for the bucket root - version switcher and workflows updated for the /en/<version> prefixes; only /en/latest is indexable Verified with a headless-browser click-through: client-side navigation, anchored cross-page links, and versioned builds all work. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 70ad620 - Browse repository at this point
Copy the full SHA 70ad620View commit details -
Upload the built site as a CI artifact for PR previews
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 4c683bf - Browse repository at this point
Copy the full SHA 4c683bfView commit details -
Remove the R2 deploy/release workflows
Hosting is still to be decided; CI keeps building and uploading the site-preview artifact. The README describes what a deploy needs to do when the hosting choice lands. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 5dc3019 - Browse repository at this point
Copy the full SHA 5dc3019View commit details -
Split the changelog into one page per release
reference/changelog.md becomes a release index at its original URL, with each release at reference/changelog/vX.Y.Z.html: title from the release heading, subsections promoted one level, a 'Released <date> · View on GitHub' line, and the leftover MyST anchor targets ((v1-31-1)=) dropped. Fumadocs resolves an extensionless meta.json item to a folder before a page, so the sidebar entry now references reference/changelog.md explicitly — a single Changelog link, with the 37 release pages routable but out of the sidebar. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 6cd4a0c - Browse repository at this point
Copy the full SHA 6cd4a0cView commit details
Commits on Aug 27, 2026
-
Add a production-faithful local preview server (npm start)
Serves out/, out-segments/, and out-root/ with the same URL mapping as production — /en/latest prefix, .html files served verbatim, segment payloads resolved — replacing the scaffold's 'serve out', which broke on both the basePath and its clean-URL rewriting. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 676841b - Browse repository at this point
Copy the full SHA 676841bView commit details -
Document npm start in the local development section
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Thc5nWNbxfQ67pVDcNSkxC
Configuration menu - View commit details
-
Copy full SHA for 7c11e05 - Browse repository at this point
Copy the full SHA 7c11e05View commit details
This comparison is taking too long to generate.
Unfortunately it looks like we can’t render this comparison for you right now. It might be too big, or there might be something weird with your repository.
You can try running this command locally to see the comparison on your machine:
git diff main...claude/coding-session-p6butr