Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: sqlc-dev/docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: main
Choose a base ref
...
head repository: sqlc-dev/docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: claude/coding-session-p6butr
Choose a head ref
Checking mergeability… Don’t worry, you can still create the pull request.
  • 7 commits
  • 34 files changed
  • 1 contributor

Commits on Aug 26, 2026

  1. 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_01Thc5nWNbxfQ67pVDcNSkxC
    claude committed Aug 26, 2026
    Configuration menu
    Copy the full SHA
    361be00 View commit details
    Browse the repository at this point in the history
  2. 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
    claude committed Aug 26, 2026
    Configuration menu
    Copy the full SHA
    70ad620 View commit details
    Browse the repository at this point in the history
  3. 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
    claude committed Aug 26, 2026
    Configuration menu
    Copy the full SHA
    4c683bf View commit details
    Browse the repository at this point in the history
  4. 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
    claude committed Aug 26, 2026
    Configuration menu
    Copy the full SHA
    5dc3019 View commit details
    Browse the repository at this point in the history
  5. 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
    claude committed Aug 26, 2026
    Configuration menu
    Copy the full SHA
    6cd4a0c View commit details
    Browse the repository at this point in the history

Commits on Aug 27, 2026

  1. 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
    claude committed Aug 27, 2026
    Configuration menu
    Copy the full SHA
    676841b View commit details
    Browse the repository at this point in the history
  2. 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
    claude committed Aug 27, 2026
    Configuration menu
    Copy the full SHA
    7c11e05 View commit details
    Browse the repository at this point in the history
Loading