On Thu, Aug 27, 2026 at 10:22 AM PG Doc comments form < [email protected]> 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.
