Suggested Feedback for PostgreSQL Documentation

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.

Browse pgsql-docs by date

  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