Skip to content

docs: refresh guide and prepare wicked-sqlc v2.4.0 - #19

Merged
Stumble merged 1 commit into
mainfrom
docs/prepare-wicked-v2.4.0
Sep 9, 2026
Merged

docs: refresh guide and prepare wicked-sqlc v2.4.0#19
Stumble merged 1 commit into
mainfrom
docs/prepare-wicked-v2.4.0

Conversation

@Stumble

@Stumble Stumble commented Sep 9, 2026

Copy link
Copy Markdown
Owner

Summary

Refresh GUIDE for the merged wicked-sqlc architecture and prepare the v2.4.0
source-release notes. This PR does not create a release tag or publish a release.

Architecture and Key Decisions

  • Document regular upstream rebases, current-main versus release-tag builds,
    optional CGO, and the existing query-comment/backend contract.
  • Remove the obsolete migration-branch installation and old production-version
    list. Link to bookstore's tested runtime dependencies without upgrading them.
  • Prepare docs/releases/v2.4.0.md with upgrade instructions, compatibility
    evidence, and known limits. Keep the existing source-release distribution
    model; no new workflows or binary attachments.
  • Preserve README, including its original upstream section, and all product code.

Risks and Remaining Work

Merge this PR before tagging. Then verify the exact merged main SHA and checks,
ensure v2.4.0 remains unused, create the tag and GitHub Release, and verify a fresh
tag-clone installation. The release is not published by this PR.

The earlier Trex full-local-build memory limitation remains documented; no full
Alva service-stack E2E or downstream rollout is claimed.

Breaking Changes

None in this documentation PR.

Database Migrations

None.

Verification

  • git diff --check passed; only GUIDE, release notes, and the changelog change.
  • Both isolated installs passed:
    • GOMAXPROCS=2 GOBIN=/tmp/sqlc-v2.4-release.jAOb4e/cgo make install COMMIT_HASH=v2.4.0
    • GOMAXPROCS=2 GOBIN=/tmp/sqlc-v2.4-release.jAOb4e/nocgo make install CGO_ENABLED=0 COMMIT_HASH=v2.4.0
  • Both binaries report v2.4.0-wicked-fork.
  • GOMAXPROCS=2 go test -p 2 -count=1 ./scripts ./internal/cmd -run 'Test(ReleaseVersionMatchesGeneratedCode|Wicked)' passed.
  • node /tmp/sqlc-v2.4-release.jAOb4e/verify.mjs passed both modes' bookstore
    generate/diff, 17-file parity except version comments, CLI/header versions,
    documentation links/fences, and unchanged README checks.
  • In a temporary clone of bookstore main at 444685d1,
    GOMAXPROCS=2 go test -p 2 -count=1 ./pkg/repos/... compiled all five generated
    packages (no test files).
  • No make lint-fix target exists. Full local runtime/E2E was not rerun for
    Markdown-only changes; the existing PR CI includes the runtime checks.

Merge Order

This preparation PR first, then source-release publication from verified main.

Related PRs

Follows merged sqlc #17, #18 and Stumble/bookstore#2.

@Stumble
Stumble merged commit dec50bf into main Sep 9, 2026
13 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.

1 participant