Re: Tutorial from Chapter 2.1

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: "nonint(at)yandex(dot)ru" <nonint(at)yandex(dot)ru>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Tutorial from Chapter 2.1
Date: 2025-08-10 15:48:19
Message-ID: 2640299.1754840899@sss.pgh.pa.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> On Sunday, August 10, 2025, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> Possibly we should reword the tutorial intro a bit, to the effect
>> that you can follow along with the examples if you have a source
>> tree at hand. (Sadly, that's not going to be very many novices
>> these days.)

> I’d rather remove it from the docs and make a home for it in the wiki or,
> probably better, have a separate git repository that they could clone.

Making it buildable standalone would be a significant investment
of effort I fear. Right now it's dependent on the autoconf/makefile
infrastructure of the surrounding Postgres source tree.

The other problem would be keeping it in sync with the tutorial
docs proper. I guess we could pull those out of the main
documentation altogether, and make "the Postgres tutorial" into
a fully standalone project. But I'm not detecting a lot of
enthusiasm for doing the work.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Robert Treat 2025-08-12 23:16:40 Index / glossary adjustments for Git & GUC
Previous Message David G. Johnston 2025-08-10 15:40:27 Re: Tutorial from Chapter 2.1