agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: nonint@yandex.ru <nonint@yandex.ru>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: Tutorial from Chapter 2.1
Date: Sun, 10 Aug 2025 11:48:19 -0400
Message-ID: <2640299.1754840899@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwZU5y=tAeZ+=VSvEWXkOYSpFZvbsCwpLh35o5jJ_YQdPQ@mail.gmail.com>
References: <175481702402.800.18232366789631838341@wrigleys.postgresql.org>
	<CAKFQuwbUSS8sXhSyukodX5=oQCzLhrhMpbGLQu87A9QpOM7cHA@mail.gmail.com>
	<2637304.1754839284@sss.pgh.pa.us>
	<CAKFQuwZU5y=tAeZ+=VSvEWXkOYSpFZvbsCwpLh35o5jJ_YQdPQ@mail.gmail.com>

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Sunday, August 10, 2025, Tom Lane <tgl@sss.pgh.pa.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





view thread (7+ messages)  latest in thread

Message-ID: <2640299.1754840899@sss.pgh.pa.us>
Permalink:  ../2640299.1754840899@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/2640299.1754840899@sss.pgh.pa.us

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, nonint@yandex.ru, pgsql-docs@lists.postgresql.org
  Subject: Re: Tutorial from Chapter 2.1
  In-Reply-To: <2640299.1754840899@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox