Skip to content

docs: ORM-first README, refreshed setup docs, 1 MB result limit#176

Merged
jeremydaly merged 2 commits into
mainfrom
docs/v2.4-readme
Jun 16, 2026
Merged

docs: ORM-first README, refreshed setup docs, 1 MB result limit#176
jeremydaly merged 2 commits into
mainfrom
docs/v2.4-readme

Conversation

@jeremydaly

Copy link
Copy Markdown
Owner

Summary

Documentation-only changes ahead of the v2.4 release (which adds the Prisma compat layer). No code changes.

  • Reordered the intro to lead with the ORM/query-builder compatibility layers (mysql2, pg, Knex, Prisma), then raw SQL, then the built-in transactions and scale-to-zero retry. The compatibility story is the main reason to reach for this library, so it goes first.
  • What's New / changelog: added a What's New for v2.4 (Prisma support) and moved the v2.3 Knex notes down into the changelog.
  • Refreshed "Enabling Data API": the old walkthrough used 2019 console screenshots and the legacy v1 flow. Replaced it with links to the current AWS docs (enabling, authorizing access / Secrets Manager + IAM, region availability), which stay accurate as the console changes. Kept Required Permissions and dropped rds-data:ExecuteSql, the deprecated v1 action this SDK v3 client never calls.
  • Documented the ~1 MB result limit: a single statement's result is capped at about 1 MB and the Data API has no server-side pagination, so the new limitations note points at keyset pagination (and notes the ORM layers already handle it).
  • Copy cleanup: removed a 2018 blog link, fixed past-tense version references ("v2.1 introduced…"), and removed em-dash-heavy phrasing.

Test plan

  • Render the README on GitHub: new intro order, What's New v2.4, Enabling links, the 1 MB limitations note
  • Confirm the three AWS doc links resolve

…nt the 1 MB result limit

- Lead the intro with the ORM/query-builder compatibility layers, then raw SQL, then the built-in transactions + retry logic
- Add a What's New section for v2.4 (Prisma support) and move v2.3 (Knex) into the changelog
- Replace the outdated Enabling Data API walkthrough (2019 screenshots, old console flow) with links to the current AWS docs; keep the Required Permissions and drop the deprecated rds-data:ExecuteSql action this SDK v3 client never calls
- Document the ~1 MB per-statement result limit and that the Data API has no server-side pagination, with guidance to use keyset pagination (ORM layers already handle it)
- Remove a 2018 blog link, fix past-tense version references, and clear out em-dash-heavy phrasing
@jeremydaly jeremydaly merged commit 4c276c6 into main Jun 16, 2026
@jeremydaly jeremydaly deleted the docs/v2.4-readme branch June 16, 2026 17:52
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