Re: DOCS - Add introductory paragraph to Getting Started chapter

Dragos Andriciuc <dragos.andriciuc@percona.com>

From: Dragos Andriciuc <dragos.andriciuc@percona.com>
To: Tom Lane <tgl@sss.pgh.pa.us>, "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Chao Li <li.evan.chao@gmail.com>, Philip Alger <paalger0@gmail.com>, Andreas Karlsson <andreas@proxel.se>, "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>
Date: 2026-04-22T09:45:49Z
Lists: pgsql-hackers
Hello Tom,
Thank you for the review, I agree with you.
For this patch, I focused on Chapter 1 to improve the initial onboarding experience, but you’re right that Chapters 2 and 3 would benefit from introductory paragraphs as well.
I will address these in a follow up update to keep the structure consistent and intact in the tutorial.
I appreciate the feedback.
Best regards,
Dragos

________________________________
From: Tom Lane <tgl@sss.pgh.pa.us>
Sent: Thursday, March 26, 2026 8:14 PM
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: Chao Li <li.evan.chao@gmail.com>; Dragos Andriciuc <dragos.andriciuc@percona.com>; Philip Alger <paalger0@gmail.com>; Andreas Karlsson <andreas@proxel.se>; pgsql-hackers@postgresql.org <pgsql-hackers@postgresql.org>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Thu, Feb 26, 2026 at 1:49 AM Chao Li <li.evan.chao@gmail.com> wrote:
>>> <v3-0001-Add-introductory-paragraph-to-Getting-Started-chapter.patch>

>> V3 seems very polished. I agree the new paragraph is a helpful improvement
>> for new doc readers.

> Works for me.

I have no particular objection to this patch, but I wonder why it
only addresses the tutorial's Chapter 1.  Chapters 2 and 3 likewise
lack any introductory paragraph.

                        regards, tom lane