| Lists: | pgsql-hackers |
|---|
| From: | Dapeng Wang <wangdp20191008(at)gmail(dot)com> |
|---|---|
| To: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-08 01:05:41 |
| Message-ID: | CAKx0YhzAMmbua4e0He+B_fi7hkMGunxYg8tHyMU6BoZS_8Z58w@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Hi,
Following up on Tom's suggestion that Chapters 2 and 3 of the
tutorial likewise lack introductory paragraphs, I've attached a
patch that adds them.
Chapter 2 (The SQL Language) gets a paragraph summarizing tables,
queries, joins, aggregates, and data modification.
Chapter 3 (Advanced Features) gets a paragraph summarizing views,
foreign keys, transactions, window functions, and inheritance.
Regards,
Dapeng Wang
| Attachment | Content-Type | Size |
|---|---|---|
| 0001-doc-add-introductory-paragraphs-to-tutorial-Chapters.patch | application/octet-stream | 1.6 KB |
| From: | Andreas Karlsson <andreas(at)proxel(dot)se> |
|---|---|
| To: | Dapeng Wang <wangdp20191008(at)gmail(dot)com>, pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-09 12:55:34 |
| Message-ID: | 1c36b321-63b8-4fa5-8e59-ca535cb0c31a@proxel.se |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
On 4/8/26 3:05 AM, Dapeng Wang wrote:
> Following up on Tom's suggestion that Chapters 2 and 3 of the
> tutorial likewise lack introductory paragraphs, I've attached a
> patch that adds them.
Thanks for the contribution!
In the future use "Reply all" and figure out why your email client did
not add a proper Reply-To header.
--
Andreas Karlsson
Percona
| From: | Dapeng Wang <wangdp20191008(at)gmail(dot)com> |
|---|---|
| To: | Andreas Karlsson <andreas(at)proxel(dot)se> |
| Cc: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-10 00:36:55 |
| Message-ID: | CAKx0Yhy23-riWqeHK5H06z7OgBc8qsmjUzuKR=xm84gpoS3w9A@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Thanks Andreas! Noted - I didn't have the original thread
in my mailbox at the time, but I'm subscribed now so future
replies will thread properly.
Regards,
Dapeng Wang
Andreas Karlsson <andreas(at)proxel(dot)se> 于2026年4月9日周四 20:55写道：
> On 4/8/26 3:05 AM, Dapeng Wang wrote:
> > Following up on Tom's suggestion that Chapters 2 and 3 of the
> > tutorial likewise lack introductory paragraphs, I've attached a
> > patch that adds them.
> Thanks for the contribution!
>
> In the future use "Reply all" and figure out why your email client did
> not add a proper Reply-To header.
>
> --
> Andreas Karlsson
> Percona
>
>
| From: | Andreas Karlsson <andreas(at)proxel(dot)se> |
|---|---|
| To: | Dapeng Wang <wangdp20191008(at)gmail(dot)com> |
| Cc: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-10 00:40:33 |
| Message-ID: | 20cde50b-fc2f-4eef-a295-07b70bc501dd@proxel.se |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
On 4/10/26 2:36 AM, Dapeng Wang wrote:
> Thanks Andreas! Noted - I didn't have the original thread
> in my mailbox at the time, but I'm subscribed now so future
> replies will thread properly.
I see! Then the general recommendation is to use the re-send email
button in our mailing list archives. I know it was buggy some time ago
but I think it has been fixed now.
Andreas
| From: | Dapeng Wang <wangdp20191008(at)gmail(dot)com> |
|---|---|
| To: | Andreas Karlsson <andreas(at)proxel(dot)se> |
| Cc: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-10 00:47:04 |
| Message-ID: | CAKx0Yhy2K+H=6tbd0j3xqtWt6PxAaaxHdwEGTVvQqTSqgmf08g@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Good to know, thanks! I'll use the resend email button next time.
Andreas Karlsson <andreas(at)proxel(dot)se> 于2026年4月10日周五 08:40写道：
> On 4/10/26 2:36 AM, Dapeng Wang wrote:
> > Thanks Andreas! Noted - I didn't have the original thread
> > in my mailbox at the time, but I'm subscribed now so future
> > replies will thread properly.
>
> I see! Then the general recommendation is to use the re-send email
> button in our mailing list archives. I know it was buggy some time ago
> but I think it has been fixed now.
>
> Andreas
>
>
| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Andreas Karlsson <andreas(at)proxel(dot)se> |
| Cc: | Dapeng Wang <wangdp20191008(at)gmail(dot)com>, pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-10 00:47:37 |
| Message-ID: | 3439055.1775782057@sss.pgh.pa.us |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Andreas Karlsson <andreas(at)proxel(dot)se> writes:
> On 4/10/26 2:36 AM, Dapeng Wang wrote:
>> Thanks Andreas! Noted - I didn't have the original thread
>> in my mailbox at the time, but I'm subscribed now so future
>> replies will thread properly.
> I see! Then the general recommendation is to use the re-send email
> button in our mailing list archives. I know it was buggy some time ago
> but I think it has been fixed now.
Yeah, I use that all the time when I want to reply to some old
thread that I no longer have locally. It's been flaky once or
twice for me, but normally it works fine.
A more pressing problem is that this iteration of the thread
isn't attached to the CF entry; you need to do that so that
it shows up as having current traffic. Right now,
https://commitfest.postgresql.org/patch/6506/
still shows the 19-Feb patch as current.
regards, tom lane
| From: | Dapeng Wang <wangdp20191008(at)gmail(dot)com> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | Andreas Karlsson <andreas(at)proxel(dot)se>, pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-10 01:03:54 |
| Message-ID: | CAKx0Yhw4vROon=_e+1XcaxM=nG9qauy5kHmMWFeeufXZ8MDM8g@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Done - I've attached the new thread to the CF entry.
Regards,
Dapeng Wang
Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> 于2026年4月10日周五 08:47写道：
> Andreas Karlsson <andreas(at)proxel(dot)se> writes:
> > On 4/10/26 2:36 AM, Dapeng Wang wrote:
> >> Thanks Andreas! Noted - I didn't have the original thread
> >> in my mailbox at the time, but I'm subscribed now so future
> >> replies will thread properly.
>
> > I see! Then the general recommendation is to use the re-send email
> > button in our mailing list archives. I know it was buggy some time ago
> > but I think it has been fixed now.
>
> Yeah, I use that all the time when I want to reply to some old
> thread that I no longer have locally. It's been flaky once or
> twice for me, but normally it works fine.
>
> A more pressing problem is that this iteration of the thread
> isn't attached to the CF entry; you need to do that so that
> it shows up as having current traffic. Right now,
>
> https://commitfest.postgresql.org/patch/6506/
>
> still shows the 19-Feb patch as current.
>
> regards, tom lane
>
| From: | Peter Eisentraut <peter(at)eisentraut(dot)org> |
|---|---|
| To: | Dapeng Wang <wangdp20191008(at)gmail(dot)com>, pgsql-hackers(at)lists(dot)postgresql(dot)org |
| Subject: | Re: DOCS - Add introductory paragraph to Getting Started chapter |
| Date: | 2026-04-15 18:03:55 |
| Message-ID: | da3ca6d0-8ba4-42d2-896d-dc43c4dadce3@eisentraut.org |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Lists: | pgsql-hackers |
On 08.04.26 03:05, Dapeng Wang wrote:
> Following up on Tom's suggestion that Chapters 2 and 3 of the
> tutorial likewise lack introductory paragraphs, I've attached a
> patch that adds them.
In each of these chapters, the first section is titled "Introduction"
and the first sentence introduces the chapter. So the text you are
proposing to add here appears to be redundant with that.