Re: Documentation: 21.5. Default Roles

2020-01-07 Thread Laurenz Albe
On Fri, 2019-12-27 at 12:16 -0500, Bruce Momjian wrote:
> On Fri, Dec 27, 2019 at 05:44:10AM +, PG Doc comments form wrote:
> > 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.
> > 
> 
> Good points.  I have developed the attached documentation patch which
> includes your ideas.

+1

I think that "predefined role" is better than "default role".

Yours,
Laurenz Albe
-- 
Cybertec | https://www.cybertec-postgresql.com





Re: Put cluster in the hierarchy in 22.1

2020-01-07 Thread Laurenz Albe
On Fri, 2020-01-03 at 03:35 +, PG Doc comments form wrote:
> Page: https://www.postgresql.org/docs/12/manage-ag-overview.html
> Description:
> 
> 22.1 says "So the full hierarchy is: server, database, schema, table (or
> some other kind of object, such as a function)." Could "cluster" be added in
> there for completeness sake?  "So the full hierarchy is: server, cluster,
> database, schema, table (or some other kind of object, such as a function)."
> It might be nice to have a graphic showing the relationships, adding other
> things as well: columns, constraints, triggers, etc.

"Server" and "cluster" are synonymous here.
Perhaps we should include "cluster" in parentheses behind "server".

Yours,
Laurenz Albe
-- 
Cybertec | https://www.cybertec-postgresql.com