Skip to content

docs: integrate Quick Start guide and documentation into README - #2632

Merged
jackc merged 3 commits into
jackc:masterfrom
VedantMadane:docs/readme-documentation-section
Aug 24, 2026
Merged

docs: integrate Quick Start guide and documentation into README#2632
jackc merged 3 commits into
jackc:masterfrom
VedantMadane:docs/readme-documentation-section

Conversation

@VedantMadane

Copy link
Copy Markdown
Contributor

Summary

Adds a text Documentation section to the README with links to:

  • pkg.go.dev API reference
  • getting started wiki
  • connection string / pgconn.ParseConfig docs (URL and keyword/value forms)

Makes the docs discoverable beyond the small pkg.go.dev badge.

Fixes #669

Link pkg.go.dev, the getting started wiki, and connection string docs so API reference is easy to find without relying on the badge alone.

Signed-off-by: Vedant Madane <6527493+VedantMadane@users.noreply.github.com>
@jackc

jackc commented Aug 21, 2026

Copy link
Copy Markdown
Owner

I don't mind making some changes here, but having the link to the Getting Started wiki page repeated twice in 6 lines doesn't fill me with confidence are the right changes. If I were to change something I would probably integrate a quick start guide into the README.

- Add installation instructions (`go get github.com/jackc/pgx/v5`)
- Group basic example and connection configuration under Quick Start
- Provide structured Documentation links for pgx, pgxpool, and stdlib
- Avoid duplicate links to the Getting Started wiki page

Signed-off-by: Vedant Madane <6527493+VedantMadane@users.noreply.github.com>
Signed-off-by: Vedant Madane <6527493+VedantMadane@users.noreply.github.com>
@VedantMadane

VedantMadane commented Aug 21, 2026

Copy link
Copy Markdown
Contributor Author

I have updated the README to integrate a Quick Start section (installation, usage example and connection string configuration) and a Documentation section pointing to the pgx, pgxpool, and stdlib pkg.go.dev docs removing the wiki link.

Pushed in commit c26469b.

@VedantMadane VedantMadane changed the title docs: add explicit Documentation section to README docs: integrate Quick Start guide and documentation into README Aug 21, 2026
@VedantMadane
VedantMadane force-pushed the docs/readme-documentation-section branch from c26469b to 3bfc268 Compare August 22, 2026 13:20
@jackc
jackc merged commit 1bc0029 into jackc:master Aug 24, 2026
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.

Reminder: there is no documentation

2 participants