3 ms·
Parts of the documentation are very good. For example https://www.postgresql.org/docs/13/wal-configuration.html https://www.postgresql.org/docs/13/wal-configur
by mjw1007 5y ago
Parts of the documentation are very good.
For example https://www.postgresql.org/docs/13/wal-configuration.html 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.)