Documentation: 21.5. Default Roles

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: rirans(at)comcast(dot)net
Subject: Documentation: 21.5. Default Roles
Date: 2019-12-27 05:44:10
Message-ID: 157742545062.1149.11052653770497832538@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2019-12-27 17:16:54 Re: Documentation: 21.5. Default Roles
Previous Message PG Doc comments form 2019-12-26 10:32:31 Concurrency