On Sun, Aug 10, 2025 at 11:48 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>
> "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.
>
Would it be easier enough to modify the existing bits to generate a
postgres tutorial extension that was distributed like the other
contrib modules in core? This would also give existing packagers a
simple way to make this available (or not) on their systems. Thoughts?
Robert Treat
https://xzilla.net
