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
