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.
