Skip to content

Prefer use of "Postgres" over "PostgreSQL" in docs - #1482

Merged
brandur merged 1 commit into
masterfrom
brandur-postgres
Oct 8, 2026
Merged

brandur merged 1 commit into
masterfrom
brandur-postgres

Conversation

@brandur

@brandur brandur commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

I just noticed while reading our Rust crate's README that the use of
"PostgreSQL" in documentation is a dead to rights giveaway that
everything is LLM-written. There's no correct form of "Postgres" versus
"PostgreSQL", but most people in the know (so to speak) tend to write
just "Postgres" and IMO it reads more fluently, though of course this is
subjective.

Here, go through all our public-facing docs and descriptions and convert
uses of "PostgreSQL" to "Postgres".

@brandur
brandur requested a review from bgentry October 8, 2026 06:02

@bgentry bgentry left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, maybe this is worth a line in AGENTS.md to steer agents this direction?

I just noticed while reading our Rust crate's README that the use of
"PostgreSQL" in documentation is a dead to rights giveaway that
everything is LLM-written. There's no correct form of "Postgres" versus
"PostgreSQL", but most people in the know (so to speak) tend to write
just "Postgres" and IMO it reads more fluently, though of course this is
subjective.

Here, go through all our public-facing docs and descriptions and convert
uses of "PostgreSQL" to "Postgres".
@brandur

brandur commented Oct 8, 2026

Copy link
Copy Markdown
Contributor Author

@bgentry Thx! I threw a terminology line into AGENTS.md.

@brandur
brandur merged commit a9c9369 into master Oct 8, 2026
62 checks passed
@brandur
brandur deleted the brandur-postgres branch October 8, 2026 15:30
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.

2 participants