Re: improve predefined roles documentation
Nathan Bossart <nathandbossart@gmail.com>
From: Nathan Bossart <nathandbossart@gmail.com>
To: Robert Haas <robertmhaas@gmail.com>
Cc: "David G. Johnston" <david.g.johnston@gmail.com>, pgsql-hackers@postgresql.org
Date: 2024-06-24T21:53:23Z
Lists: pgsql-hackers
Attachments
- v3-0001-revamp-predefined-roles-documentation.patch (text/plain)
On Mon, Jun 24, 2024 at 02:44:33PM -0400, Robert Haas wrote: > I think the first two cases could be made more like each other by > changing the varlistentires that are just about one setting to use the > second format instead of the first, e.g. pg_checkpoint allows > executing the CHECKPOINT command. Done. > I don't know what to do about pg_database_owner. I almost wonder if > that should be moved out of the table and documented as a special > case. Or maybe some more wordsmithing would add clarity. Or maybe it's > fine as-is. I've left it alone for now. I thought about adding something like "pg_database_owner does not provide any special capabilities or access out-of-the-box" to the beginning of the entry, but I don't have time at the moment to properly wordsmith the rest. If anyone else wants to give it a try before I get to it (probably tomorrow), please be my guest. TBH I think the existing content is pretty good, so I'm not opposed to leaving it alone, even if the style is different than the other entries. -- nathan
Commits
-
Revamp documentation for predefined roles.
- cc2236854e2b 18.0 landed
-
Introduce pg_signal_autovacuum_worker.
- ccd38024bc3c 18.0 cited