Postgres by Example

A simple database guide drops, and the comments instantly turn into a trust battle

TLDR: Postgres by Example is a new beginner-friendly guide meant to teach a popular database through simple examples. Commenters immediately split between helpful recommendations and blunt skepticism, with some praising easy learning tools while others questioned the guide’s depth and trustworthiness.

A new project called Postgres by Example just arrived with a very straightforward promise: teach people how to use PostgreSQL, a popular tool for storing and organizing data, through step-by-step examples. On paper, it sounds wonderfully practical — from first queries to tables, joins, transactions, and even security. Basically, it wants to be the friendly walk-through for anyone trying to stop staring blankly at a command line and actually learn the thing.

But the real action? The comment section came in hot. One camp was supportive and immediately started tossing in extra homework, with one user recommending Tobias Petry’s books as an easier, more polished companion read via SQL for Devs. The other camp was absolutely not in a generous mood. The sharpest side-eye came from a commenter who recognized the group behind the project and brought up its connection to an earlier AI-generated Zig by Example repo, summing up the vibe with a brutal little “Hard pass.” Ouch.

Then came the quality-control crowd, who said the guide feels too shallow to be truly useful. One critic dragged the odd topic groupings — yes, people really got mad about how subjects were paired together — and argued that key details were missing. So while the site is trying to be beginner-friendly, the community response is split between “nice intro” and “this feels flimsy, rushed, and maybe a little suspicious.” In other words: classic internet launch energy.

Key Points

  • The article introduces "Postgres by Example" as a hands-on PostgreSQL tutorial based on annotated SQL examples.
  • It requires PostgreSQL to be installed, the server running, and user access through `psql`, with the default database set to `postgres` unless noted otherwise.
  • The resource covers a wide range of PostgreSQL topics, including querying, data types, DDL, DML, joins, aggregation, subqueries, functions, indexes, transactions, views, security, and `psql` tools.
  • Examples are intended for the current stable PostgreSQL release, and readers are advised to use the latest version available if issues occur.
  • The material is credited to Dariush Abbasi and is licensed under CC BY 4.0.

Hottest takes

"Hard pass." — xerox13ster
"a bit too superficial" — fabian2k
"Really easy to read" — p2detar
Made with <3 by @siedrix and @shesho from CDMX. Powered by Forge&Hive.