The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/12/default-roles.html Description:
The title is wrong. The roles are not defaults; they are predefined and privileged. The title suggests that a user should expect to be assigned these roles. "21.5 Sub-Administrator Roles" would be accurate--improving clarity over all and removing any need to explain why postgres is not in this list of roles. THE EXISTING 1st Paragraph: PostgreSQL provides a set of default roles which provide access to certain, commonly needed, privileged capabilities and information. Administrators can GRANT these roles to users and/or other roles in their environment, providing those users with access to the specified capabilities and information. A possible replacement: PostgreSQL provides predefined roles which allow access to various actions and information otherwise reserved to superusers. Administrators can GRANT these roles like any other role, but these roles are also special for allowing abilities not defined by any standard. Additionally: "commonly" above is confusing because the "administrative" context has not been introduced. In the paragraph following the table, the 2nd sentence starts: They grant a set of common privileges allowing the role to read various useful configuration settings, is better: They grant a set of privileges allowing the role to read various configuration settings, "Common" and "useful" are just noise at best. Everywhere in the section "default roles" should be "predefined roles". Though a note of the old title could be helpful to some searchers. Thank you.
