Skip to content

docs: correct stale postgresql comment + enrich jwt godoc#7

Merged
datariot merged 1 commit into
mainfrom
docs/godoc-bundle-followup
Jul 7, 2026
Merged

docs: correct stale postgresql comment + enrich jwt godoc#7
datariot merged 1 commit into
mainfrom
docs/godoc-bundle-followup

Conversation

@datariot

@datariot datariot commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Follow-up doc-comment pass on the bundles (doc comments only, no behavior change).

  • postgresql: Initialize's comment claimed it 'performs migrations if configured' — it does not run migrations (a deployment concern per the package doc). Corrected to describe what it actually does: validate → open pool → apply limits → ping.
  • jwt: enriched ServiceID/ServiceName (context-population mechanism, empty-string-on-no-claims contract), documented the TokenValidator.ValidateToken interface method, and deepened the TokenValidator type doc.

Build, vet, lint (0 issues), and bundle tests all clean.

🤖 Generated with Claude Code

Late-arriving godoc pass on the bundles:
- postgresql: Initialize no longer claims it 'performs migrations if configured' — the bundle does not run migrations (a deployment concern per the package doc); comment now describes validate -> open pool -> apply limits -> ping
- jwt: enrich ServiceID/ServiceName (explain context-population mechanism, empty-string-on-no-claims), document TokenValidator.ValidateToken interface method and deepen the TokenValidator type doc

Doc comments only; build/vet/lint/tests clean.

Co-Authored-By: Claude Fable 5 <[email protected]>
@datariot datariot merged commit 33595e0 into main Jul 7, 2026
3 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