| 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
| 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 |