Date: Tue, 24 Oct 2023 17:39:45 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Laurenz Albe <laurenz.albe@cybertec.at>
Cc: xinyyc+postgres@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Getting started
Message-ID: <ZTg5oabdFQXEf2nb@momjian.us>
References: <167069800755.1903.2797040477164919245@wrigleys.postgresql.org>
 <29785cbd957449e98c03a77b6b9fb41970a4f1ca.camel@cybertec.at>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <29785cbd957449e98c03a77b6b9fb41970a4f1ca.camel@cybertec.at>
Archived-At: 
 <https://www.postgresql.org/message-id/ZTg5oabdFQXEf2nb%40momjian.us>
Precedence: bulk

xOn Mon, Dec 12, 2022 at 08:20:03AM +0100, Laurenz Albe wrote:
> On Sat, 2022-12-10 at 18:46 +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> > 
> > Page: https://www.postgresql.org/docs/15/user-manag.html
> > Description:
> > 
> > https://www.postgresql.org/docs/current/tutorial-createdb.html
> > 
> > The "getting started" page skips right from the installing to already having
> > started the program, but on linux machines, you cannot start psql without
> > inputting a special command, "sudo -u postgres psql".  Typing psql will make
> > the program tell you that your username doesn't exist, and you can't create
> > a username for psql without starting psql first.  I had to search somewhere
> > else to learn that I had to start psql with that special command.  
> 
> Yes, the "initdb" step is missing.
> 
> If we had that, it would be clear that the rest of the chapter assumes that
> you are running shell commands with an operating system user whose name
> is identical to the bootstrap superuser.

I looked at this and initdb is mentioned in the installation section,
and an incorrect user name is mentions as part of craetedb failure.  I
don't see what we can add to improve things here.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.