public inbox for [email protected]
help / color / mirror / Atom feedFrom: Dapeng Wang <[email protected]>
To: [email protected]
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
Date: Wed, 8 Apr 2026 09:05:41 +0800
Message-ID: <CAKx0YhzAMmbua4e0He+B_fi7hkMGunxYg8tHyMU6BoZS_8Z58w@mail.gmail.com> (raw)
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
Attachments:
[application/octet-stream] 0001-doc-add-introductory-paragraphs-to-tutorial-Chapters.patch (1.6K, 3-0001-doc-add-introductory-paragraphs-to-tutorial-Chapters.patch)
download | inline diff:
From fd0b233c6b41a5bac0c9e3b1f4018d5da3f3878e Mon Sep 17 00:00:00 2001
From: wangdapeng <[email protected]>
Date: Wed, 8 Apr 2026 08:56:37 +0800
Subject: [PATCH] doc: add introductory paragraphs to tutorial Chapters 2 and 3
---
doc/src/sgml/advanced.sgml | 8 ++++++++
doc/src/sgml/query.sgml | 7 +++++++
2 files changed, 15 insertions(+)
diff --git a/doc/src/sgml/advanced.sgml b/doc/src/sgml/advanced.sgml
index e15a332..c0c6d12 100644
--- a/doc/src/sgml/advanced.sgml
+++ b/doc/src/sgml/advanced.sgml
@@ -3,6 +3,14 @@
<chapter id="tutorial-advanced">
<title>Advanced Features</title>
+ <para>
+ This chapter builds on the basics covered earlier and introduces
+ several advanced <acronym>SQL</acronym> features in
+ <productname>PostgreSQL</productname>, including views, foreign keys,
+ transactions, window functions, and inheritance.
+ </para>
+
+
<sect1 id="tutorial-advanced-intro">
<title>Introduction</title>
diff --git a/doc/src/sgml/query.sgml b/doc/src/sgml/query.sgml
index b190f28..1c8b6ac 100644
--- a/doc/src/sgml/query.sgml
+++ b/doc/src/sgml/query.sgml
@@ -3,6 +3,13 @@
<chapter id="tutorial-sql">
<title>The <acronym>SQL</acronym> Language</title>
+ <para>
+ This chapter introduces fundamental <acronym>SQL</acronym> operations
+ in <productname>PostgreSQL</productname>, including creating tables,
+ populating them with data, and querying them. It also covers joins
+ between tables, aggregate functions, and how to update and delete data.
+ </para>
+
<sect1 id="tutorial-sql-intro">
<title>Introduction</title>
--
2.46.2.windows.1
view thread (11+ 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]
Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter
In-Reply-To: <CAKx0YhzAMmbua4e0He+B_fi7hkMGunxYg8tHyMU6BoZS_8Z58w@mail.gmail.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