Re: DOCS - Add introductory paragraph to Getting Started chapter

From: Dragos Andriciuc <dragos(dot)andriciuc(at)percona(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>, Philip Alger <paalger0(at)gmail(dot)com>, Andreas Karlsson <andreas(at)proxel(dot)se>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
Date: 2026-04-22 09:45:49
Message-ID: LO7P302MB225477AEAD933D6409B1F06AF82D2@LO7P302MB2254.GBRP302.PROD.OUTLOOK.COM
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
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(at)sss(dot)pgh(dot)pa(dot)us>
Sent: Thursday, March 26, 2026 8:14 PM
To: David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>; Dragos Andriciuc <dragos(dot)andriciuc(at)percona(dot)com>; Philip Alger <paalger0(at)gmail(dot)com>; Andreas Karlsson <andreas(at)proxel(dot)se>; pgsql-hackers(at)postgresql(dot)org <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter

"David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> On Thu, Feb 26, 2026 at 1:49 AM Chao Li <li(dot)evan(dot)chao(at)gmail(dot)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

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Andrey Borodin 2026-04-22 09:48:50 Re: Feature: Use DNS SRV records for connecting
Previous Message Xuneng Zhou 2026-04-22 09:43:56 Re: [WIP] Pipelined Recovery