News for hackers. Stuff that matters.
Re:In Praise of PostgreSQL by fabian2k on Thursday August 05, 2021 @12:43PM (#28076173)
I'll second the praise for the Postgres documentation. I learned a lot about Postgres simply by looking through the documentation and reading the parts that looked interesting.
Re:In Praise of PostgreSQL by mjw1007 on Thursday August 05, 2021 @01:20PM (#28076713)
Parts of the documentation are very good.

For example https://www.postgresql.org/docs/13/wal-configuration.html is done properly: it describes what that part of the program actually does, with the settings that affect it introduced at the appropriate point, separately from the reference documentation which lists the same settings in alphabetical order.

But not all aspects of Postgres get this quality of documentation. It would be good to see a similar treatment of the checks the planner or executor performs to decide whether to permit access to a particular table and column and row, rather than having to deduce it from the separate descriptions of the security features.

(For example, the basic fact that a VIEW accesses a table using the privileges of the view's owner, not those of the user executing the query, is very hard to find in the documentation.)

Re:In Praise of PostgreSQL by funcDropShadow on Thursday August 05, 2021 @04:03PM (#28078887)
It is great that you can switch on any page in the documentation to the documentation of another release of PostgreSQL. That is extremely helpful if you are working with different versions.
Re:In Praise of PostgreSQL by p_l on Thursday August 05, 2021 @01:37PM (#28076964)
Not just about postgres internals, but generally about SQL in my case.

Interestingly enough the competition for "biggest impact on my SQL Knowledge"... Is a book about MS Access 97 which taught me enough about how SQL actually works that I could understand Postgres docs.

Re:In Praise of PostgreSQL by djk447 on Thursday August 05, 2021 @12:45PM (#28076197)
Same here. I feel like I built several years of my career on reading that documentation and knowing where to find things when other folks didn't, so they'd come and ask me and I'd just send them to the right place.