On Tuesday, November 5, 2019, PG Doc comments form <
noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/12/ddl-alter.html
Description:
In 5.6.1. Adding a Column, there is a kind of example 'ALTER TABLE products
ADD COLUMN description text;'
The words 'description' and 'text' are misleading -- as according to the
formal documentation of the SQL command
(https://www.postgresql.org/docs/12/sql-altertable.html), they should be
'column_name' and 'data_type'.
A similar problem exists for removing a column, and other actions.
Chapter 5 is tutorial-like and uses actual meaningful names instead of syntax placeholders. I don’t really see a problem aside from maybe a different example name could be chosen. Making it column_name isn’t an improvement.
David J.