docs(storage): bring docs up to parity with last 30 days of code + IA audit

[bgrenon]

Summary

Brings Storage docs up to parity with the last 30 days of hadron/neon-cloud changes, plus fixes from a persona-driven IA read-through.

Changes

• storage/get-started.md
  • Reordered prerequisites: {project_id}/{branch_id} lookup now comes before the first manual API call
  • Promoted bucket creation to its own explicit step; moved endpoint lookup before credentials
  • Added a branch-readiness note and 404 troubleshooting guidance
• introduction/architecture-overview.md
  • Corrected a commit-latency/fsync behavior claim (DOC-26588)

Verified, not changed

• neon.neon_backpressure_status() exists in the extension but is intentionally left undocumented (that reference page is scoped to LFC, not exhaustive)
• "Up to 5 protected branches" is still accurate today; flagging a forward-looking watch item — hadron PR #7196 hard-codes "one protected timeline per tenant" behind an opt-out flag with no production callers yet

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
neon-next	Building	Preview, Comment	Jul 9, 2026 11:22pm

[bgrenon]

IA-audit follow-up applied in 83283228c.\n\nFixed local Storage quickstart findings:\n- Added the missing @neon/config install, neon link, and branch confirmation steps before neon deploy.\n- Added branch creation/readiness guidance for the manual API path, including async initialization caveat.\n- Reordered manual setup to check branch Storage endpoint readiness before credential creation.\n- Clarified Storage 404 remediation: no separate manual enable step; use neon.ts or confirm private preview access and AWS us-east-2 region.\n- Promoted bucket creation to its own ordered quickstart step before upload.\n- Re-checked the Python upload snippet; the duplicate print('Uploaded!') is not present in the current file.\n- Did a quick local pass over objects.md and buckets.md; no additional small, self-contained ordering/copy-paste fixes were needed.\n\nValidation:\n- npx markdownlint --ignore-path .gitignore content/docs/storage/get-started.md content/docs/storage/objects.md content/docs/storage/buckets.md ✅\n- npm run check:docs ✅\n- Commit hook also ran npm run test:unit:run ✅\n\nNote: npm run lint:md -- content/docs/storage/get-started.md content/docs/storage/objects.md content/docs/storage/buckets.md still expands to repo-wide markdownlint and fails on unrelated pre-existing files under public/; targeted Storage markdownlint passes.

[danieltprice]

lgtm!