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: y.saburov@gmail.com
Subject: tutorial
Date: Mon, 24 Aug 2026 06:54:11 +0000
Message-ID: <178755445123.2606577.4366583624897339635@wrigleys.postgresql.org> (raw)

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/tutorial-accessdb.html
Description:

In the guide, you provide examples of creating the mydb database and taking
the first steps with it.

This raises the question: why does psql display:

mydb=>

Doesn’t that mean someone created this database and granted access to it?
(Because if it was you)—then you know how to grant access to a database and
create a user—so it turns out you’re an experienced user, but if you really
are: you wouldn’t be reading this section of the manual, because then you’d
be wondering—how did you manage to compile version 18.6 with the gcc
compiler (4.9.2-10) (from 2007)?

mydb=> SELECT version();
                                         version
-------------------------------------------------------------------​-----------------------
 PostgreSQL 18.6 on x86_64-pc-linux-gnu, compiled by gcc (Debian 4.9.2-10)
4.9.2, 64-bit
(1 row)

As always, you want to follow the commands step by step from the
documentation—but so many questions remain.

Section 2.1. Introduction provides the following command:

mydb=> \i basics.sql

What do you think the user should see (what should they learn)? What will
remain in the database?

Let’s hope that, over time, navigating the documentation will become easier
and more user-friendly.

view thread (29+ messages)  latest in thread

Message-ID: <178755445123.2606577.4366583624897339635@wrigleys.postgresql.org>
Permalink:  ../178755445123.2606577.4366583624897339635@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/178755445123.2606577.4366583624897339635@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, y.saburov@gmail.com
  Subject: Re: tutorial
  In-Reply-To: <178755445123.2606577.4366583624897339635@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