public inbox for [email protected]  
help / color / mirror / Atom feed
From: Dragos Andriciuc <[email protected]>
To: Tom Lane <[email protected]>
To: David G. Johnston <[email protected]>
Cc: Chao Li <[email protected]>
Cc: Philip Alger <[email protected]>
Cc: Andreas Karlsson <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
Date: Wed, 22 Apr 2026 09:45:49 +0000
Message-ID: <LO7P302MB225477AEAD933D6409B1F06AF82D2@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM> (raw)
In-Reply-To: <[email protected]>
References: <LO7P302MB2254ED63D99DEC176E8C50FEF86DA@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM>
	<[email protected]>
	<CAM-ipWdfB3npDkT+xZbtBz_qAbewFE784BdY1a2zRUGmC1xPwA@mail.gmail.com>
	<CAPXBC8K0j-=zymexP+nxFAzKuDd9cz5HUi_sC4xvuPwJGAUB_w@mail.gmail.com>
	<CAKFQuwZjMOKiLXUFPFLvxLRBzd=GLV6HXPzn4brsFbvHAQzufg@mail.gmail.com>
	<LO7P302MB2254B600583EC8938F7931D3F86BA@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM>
	<[email protected]>
	<CAKFQuwYpLgzX0xNw8NKF9GtyekPWEs-TbA-0U0imVKC9yp3xiQ@mail.gmail.com>
	<[email protected]>

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 <[email protected]>
Sent: Thursday, March 26, 2026 8:14 PM
To: David G. Johnston <[email protected]>
Cc: Chao Li <[email protected]>; Dragos Andriciuc <[email protected]>; Philip Alger <[email protected]>; Andreas Karlsson <[email protected]>; [email protected] <[email protected]>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter

"David G. Johnston" <[email protected]> writes:
> On Thu, Feb 26, 2026 at 1:49 AM Chao Li <[email protected]> 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



view thread (15+ messages)  latest in thread

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
  In-Reply-To: <LO7P302MB225477AEAD933D6409B1F06AF82D2@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM>

* 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