Re: tutorial

On Thu, Aug 27, 2026 at 10:22 AM PG Doc comments form <
noreply(at)postgresql(dot)org> wrote:

> 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?
>

Yes, the user supposedly did when performing the exercise in chapter 1.3

> 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.
>
>
That becomes more likely if people like you who wish to see this better
future suggest patches to make it happen.

Personally, I'd rather remove the tutorial from the core project and let it
be a more accessible community effort via the wiki. The legacy of it being
based upon someone possessing the source code is understandable given the
open source nature of the project but doesn't really fit today's reality.
On that front - if said wiki existed (and there really is no one stopping
it from becoming reality) and was on par in content with the documentation
the argument to simply stop maintaining the tutorial in the docs would be
possible to make.

David J.