Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wAl6p-000IT4-1O for pgsql-hackers@arkaria.postgresql.org; Thu, 09 Apr 2026 08:51:31 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1wAl6n-004k1J-2m for pgsql-hackers@arkaria.postgresql.org; Thu, 09 Apr 2026 08:51:30 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wAHMi-003cGM-15 for pgsql-hackers@lists.postgresql.org; Wed, 08 Apr 2026 01:05:56 +0000 Received: from mail-dy1-x1342.google.com ([2607:f8b0:4864:20::1342]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.98.2) (envelope-from ) id 1wAHMg-000000018GD-41yW for pgsql-hackers@lists.postgresql.org; Wed, 08 Apr 2026 01:05:55 +0000 Received: by mail-dy1-x1342.google.com with SMTP id 5a478bee46e88-2ce102afb0aso4450945eec.1 for ; Tue, 07 Apr 2026 18:05:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1775610354; cv=none; d=google.com; s=arc-20240605; b=R3exV37n9zfMzeoYNXfZaMcu1HcTbzkS9fr07g0UIaIIlSm2yOd1b4Uy4oYPvjb4Qc 71r0aLVk99R/nIfsyN+SvPZeTgCBq81eG+FWrLmHtvzhqTGQ97lkrH/4uXffXmqCGQVd mbhaHN11pEJCZQAfUQf2DNUjEk/GEGrwyJG872JPy+5S4md1DuLrqxBs1nfWIS0k8t8y 4WipejtzLRb7cikGGkwq8ZNhItIcfxJvlmt9Bt1+oppukGAu6kW/YQT8XOL59fFYkx9t bM4Rv4QUAcgzHi2bGdEUAzwDD/yqEPMx4qjn1mxTDrDrXBeLvQNdTfaF6R3WXFh03jNr 83/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=to:subject:message-id:date:from:mime-version:dkim-signature; bh=UkpjHysnd5HQ5e1gPMPUInByb1L/txI/Suyle/yc8H4=; fh=nwNxTtLLPTU0ewfLM7SSbrjMajMl+wwnFkCY/fi90vE=; b=JMVPjwSOJpI1njEokp1SrT0ONDFUkKjYNsEKGXwhYPB4EziCn+yr46dDEwaYgekaNZ NiAtypI6eEUG5TUkQBVQe8EjqmXE9mc2M+1iPZO9HLB77JSZjmiGh09CGqzPYdei9Ajj 6zM19efk8I/8VlfXYKebLiI0GiZlFTyxmx4TJjqCFFlGQH8varZ5xDlbooxnHFrO2VoC hZQZOiLIDMSOhW2PUKJKnggUNG0TzX4CXXkVOQxt6f6/mnLBRG7zXPQmE7m/1jD4yJq6 fZOSx80vwpvUKV5Ioc2i3ELfVy4R+ztX9jLbGOHwKhZSGfkgN44kGVLgr1k4mxSepXzA Wcjg==; darn=lists.postgresql.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1775610354; x=1776215154; darn=lists.postgresql.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=UkpjHysnd5HQ5e1gPMPUInByb1L/txI/Suyle/yc8H4=; b=BiwBeEUbBjsyfWz1cd6UCH3RDPua50xofYETyQLCcuYmtNxB2b3nwiC+gZjiysGFhi yWAUhvbbgqgK1ROTHrktAhZ8HsC0uqVWP5TNMfciwDx71UGAKzerZPg0GzBbg1BGyVTS orcIw3Qiq758y0pXQT0gGzbKIADQ7hkZHWAVylwA87kTr/uwHlDVMc4vu4d/6fzw4sLP t/0zAgFR9lxtfyT499CJHcINC1+u4llclwyeGp/i+19KGOZYTbmMEBuUhvzj04ATaCBH R10UtX8odtvsr6fTkv5O31/AuLSYIvUUdpAocwMnbsEKSHZLXS1zHMcqdYB76+jbqzbK Ch2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1775610354; x=1776215154; h=to:subject:message-id:date:from:mime-version:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=UkpjHysnd5HQ5e1gPMPUInByb1L/txI/Suyle/yc8H4=; b=VzoVCEFsrKCe2W8ilSqE4B6ssaMiW/E5s882HIHsvhXQQwRS811XaYVmvEaFP8tXdK dO2D0sGNYuAWN1PEzo5GigJDestPUAcD0WW2v3nWjKV/V7vV/OIWPOaD1pPpShGDvkSM 86RUFdvcLkfZI1jGy7Lq3VLWoMuuEBU78COXVoADZViq5AbXiGDA+3/wnlk0pxWWaFRJ dgqQtaz4NGxddTnNlIZX7ELSc8XYEeQNgEZfpEW9QEFSn5xx/PPJcmCn++ln+q7urn/d tP+jMwF05gioDHIaydoGQbYxsTwyLOu7NNfKfzqEEP7mnn7wvgfY9Y/EL0zTO0x6axAn /zPQ== X-Gm-Message-State: AOJu0Yx1qBmM11rQfUIHFWOKlFwY5toSB9zbxPLaTY2TTh3BlpD60xmx n2VILY53ce9Zk/8rHtyAHq9eaRDY6k9Ib7rYItK4FCigrIB2+wEuaWnBWuwnON+9z4SJj8hDf5w U/HrzNq9wFB2cKor6n65T+TTOY1+pBmzojrYI1m1MsdxS X-Gm-Gg: AeBDiet9VHxjRkEakMkctnOSBR+gdGPbLA1vCwYjHZS9kaDeaY7Iu7Ydh4evxRzqdvn bLDTydl+Q8vGVRII/YdIN7H3WEUNNMwmxJCgsGNNuWAMEQHIVlvvVWnEliSV+88DlAwM4NK3lkg AuK51TQdsfffkIi4MMjbCO/m/xlEbOtrLi5qyp0xvSy75wx89Gr1Wto6LIg4OO2qrk+g8nCNr/Y AlF3HLowodyHXPTOCzkA+MwyOmJ3yes7Hwuj7LRcchQmUPCdQtZnSkCslAVL8Pmbn7GVXZ4w4cN A6sfDgsy X-Received: by 2002:a05:7300:570f:b0:2d1:e92c:f7ff with SMTP id 5a478bee46e88-2d1e93c3eb8mr2587370eec.1.1775610353449; Tue, 07 Apr 2026 18:05:53 -0700 (PDT) MIME-Version: 1.0 From: Dapeng Wang Date: Wed, 8 Apr 2026 09:05:41 +0800 X-Gm-Features: AQROBzDbdkxOnMFdQoLJq-8t92wPLx7iZER3K8GQh8vOIf4DRAl--kW_fmetNc0 Message-ID: Subject: Re: DOCS - Add introductory paragraph to Getting Started chapter To: pgsql-hackers@lists.postgresql.org Content-Type: multipart/mixed; boundary="000000000000610562064ee880b8" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000610562064ee880b8 Content-Type: multipart/alternative; boundary="000000000000610561064ee880b6" --000000000000610561064ee880b6 Content-Type: text/plain; charset="UTF-8" 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 --000000000000610561064ee880b6 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi,

Following up on Tom's suggestion that Chapt= ers 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 da= ta modification.

Chapter 3 (Advanced Features) gets a paragraph summ= arizing views,
foreign keys, transactions, window functions, and inherit= ance.

Regards,
Dapeng Wang
--000000000000610561064ee880b6-- --000000000000610562064ee880b8 Content-Type: application/octet-stream; name="0001-doc-add-introductory-paragraphs-to-tutorial-Chapters.patch" Content-Disposition: attachment; filename="0001-doc-add-introductory-paragraphs-to-tutorial-Chapters.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_mnpccu4j0 RnJvbSBmZDBiMjMzYzZiNDFhNWJhYzBjOWUzYjFmNDAxOGQ1ZGEzZjM4NzhlIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiB3YW5nZGFwZW5nIDwzNDU3MzE5MjNAcXEuY29tPgpEYXRlOiBX ZWQsIDggQXByIDIwMjYgMDg6NTY6MzcgKzA4MDAKU3ViamVjdDogW1BBVENIXSBkb2M6IGFkZCBp bnRyb2R1Y3RvcnkgcGFyYWdyYXBocyB0byB0dXRvcmlhbCBDaGFwdGVycyAyIGFuZCAzCgotLS0K IGRvYy9zcmMvc2dtbC9hZHZhbmNlZC5zZ21sIHwgOCArKysrKysrKwogZG9jL3NyYy9zZ21sL3F1 ZXJ5LnNnbWwgICAgfCA3ICsrKysrKysKIDIgZmlsZXMgY2hhbmdlZCwgMTUgaW5zZXJ0aW9ucygr KQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9hZHZhbmNlZC5zZ21sIGIvZG9jL3NyYy9zZ21s L2FkdmFuY2VkLnNnbWwKaW5kZXggZTE1YTMzMi4uYzBjNmQxMiAxMDA2NDQKLS0tIGEvZG9jL3Ny Yy9zZ21sL2FkdmFuY2VkLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL2FkdmFuY2VkLnNnbWwKQEAg LTMsNiArMywxNCBAQAogIDxjaGFwdGVyIGlkPSJ0dXRvcmlhbC1hZHZhbmNlZCI+CiAgIDx0aXRs ZT5BZHZhbmNlZCBGZWF0dXJlczwvdGl0bGU+CiAKKyAgIDxwYXJhPgorICAgIFRoaXMgY2hhcHRl ciBidWlsZHMgb24gdGhlIGJhc2ljcyBjb3ZlcmVkIGVhcmxpZXIgYW5kIGludHJvZHVjZXMKKyAg ICBzZXZlcmFsIGFkdmFuY2VkIDxhY3JvbnltPlNRTDwvYWNyb255bT4gZmVhdHVyZXMgaW4KKyAg ICA8cHJvZHVjdG5hbWU+UG9zdGdyZVNRTDwvcHJvZHVjdG5hbWU+LCBpbmNsdWRpbmcgdmlld3Ms IGZvcmVpZ24ga2V5cywKKyAgICB0cmFuc2FjdGlvbnMsIHdpbmRvdyBmdW5jdGlvbnMsIGFuZCBp bmhlcml0YW5jZS4KKyAgIDwvcGFyYT4KKworCiAgIDxzZWN0MSBpZD0idHV0b3JpYWwtYWR2YW5j ZWQtaW50cm8iPgogICAgPHRpdGxlPkludHJvZHVjdGlvbjwvdGl0bGU+CiAKZGlmZiAtLWdpdCBh L2RvYy9zcmMvc2dtbC9xdWVyeS5zZ21sIGIvZG9jL3NyYy9zZ21sL3F1ZXJ5LnNnbWwKaW5kZXgg YjE5MGYyOC4uMWM4YjZhYyAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL3F1ZXJ5LnNnbWwKKysr IGIvZG9jL3NyYy9zZ21sL3F1ZXJ5LnNnbWwKQEAgLTMsNiArMywxMyBAQAogIDxjaGFwdGVyIGlk PSJ0dXRvcmlhbC1zcWwiPgogICA8dGl0bGU+VGhlIDxhY3JvbnltPlNRTDwvYWNyb255bT4gTGFu Z3VhZ2U8L3RpdGxlPgogCisgICA8cGFyYT4KKyAgICBUaGlzIGNoYXB0ZXIgaW50cm9kdWNlcyBm dW5kYW1lbnRhbCA8YWNyb255bT5TUUw8L2Fjcm9ueW0+IG9wZXJhdGlvbnMKKyAgICBpbiA8cHJv ZHVjdG5hbWU+UG9zdGdyZVNRTDwvcHJvZHVjdG5hbWU+LCBpbmNsdWRpbmcgY3JlYXRpbmcgdGFi bGVzLAorICAgIHBvcHVsYXRpbmcgdGhlbSB3aXRoIGRhdGEsIGFuZCBxdWVyeWluZyB0aGVtLiAg SXQgYWxzbyBjb3ZlcnMgam9pbnMKKyAgICBiZXR3ZWVuIHRhYmxlcywgYWdncmVnYXRlIGZ1bmN0 aW9ucywgYW5kIGhvdyB0byB1cGRhdGUgYW5kIGRlbGV0ZSBkYXRhLgorICAgPC9wYXJhPgorCiAg IDxzZWN0MSBpZD0idHV0b3JpYWwtc3FsLWludHJvIj4KICAgIDx0aXRsZT5JbnRyb2R1Y3Rpb248 L3RpdGxlPgogCi0tIAoyLjQ2LjIud2luZG93cy4xCgo= --000000000000610562064ee880b8--