From: | PG Doc comments form <noreply(at)postgresql(dot)org> |
---|---|
To: | pgsql-docs(at)lists(dot)postgresql(dot)org |
Cc: | runningpig66(at)gmail(dot)com |
Subject: | Suggested Feedback for PostgreSQL Documentation |
Date: | 2025-07-18 12:46:03 |
Message-ID: | 175284276345.858623.7508522254717117083@wrigleys.postgresql.org |
Views: | Whole Thread | Raw Message | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/17/ddl-default.html
Description:
https://www.postgresql.org/docs/17/ddl-default.html
uggested Feedback for PostgreSQL Documentation:
In section 5.2 where the nextval() function is introduced, it would be
helpful if the documentation provided a more complete and practical example.
Specifically:
The documentation should clearly mention that the sequence (e.g.,
products_product_no_seq) must be explicitly created before using it in a
CREATE TABLE statement, otherwise the SQL will fail.
Additionally, examples should include full, runnable SQL snippets that users
can execute directly in psql without needing to fill in missing parts.
For teaching and learning purposes, it is important to provide not only the
CREATE TABLE statement but also the necessary CREATE SEQUENCE and INSERT
statements, along with sample output to demonstrate how values are generated
by the sequence.
This would greatly improve the clarity and usability of the documentation
for learners and practitioners alike.
From | Date | Subject | |
---|---|---|---|
Next Message | Laurenz Albe | 2025-07-18 13:31:08 | Re: Plus sign in column 'Access privileges' of command \dp |
Previous Message | KES | 2025-07-18 09:28:50 | Re: Unexpected behaviour: it was documented to return the same value |