agora inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed
From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: runningpig66@gmail.com
Subject: Suggested Feedback for PostgreSQL Documentation
Date: Fri, 18 Jul 2025 12:46:03 +0000
Message-ID: <175284276345.858623.7508522254717117083@wrigleys.postgresql.org> (raw)

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.


Message-ID: <175284276345.858623.7508522254717117083@wrigleys.postgresql.org>
Permalink:  ../175284276345.858623.7508522254717117083@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/175284276345.858623.7508522254717117083@wrigleys.postgresql.org

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, runningpig66@gmail.com
  Subject: Re: Suggested Feedback for PostgreSQL Documentation
  In-Reply-To: <175284276345.858623.7508522254717117083@wrigleys.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox