Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oLNAu-00027Z-To for pgsql-docs@arkaria.postgresql.org; Tue, 09 Aug 2022 11:13:29 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1oLNAt-00020C-Qr for pgsql-docs@arkaria.postgresql.org; Tue, 09 Aug 2022 11:13:27 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oLNAt-0001xz-DB for pgsql-docs@lists.postgresql.org; Tue, 09 Aug 2022 11:13:27 +0000 Received: from mail.postgrespro.ru ([93.174.131.139]) by makus.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1oLNAq-0002yB-2G for pgsql-docs@lists.postgresql.org; Tue, 09 Aug 2022 11:13:26 +0000 Received: from [192.168.28.21] (cyclops.postgrespro.ru [93.174.131.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mail.postgrespro.ru (Postfix) with ESMTPSA id 0A7CA21C5CB2 for ; Tue, 9 Aug 2022 14:13:22 +0300 (MSK) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=postgrespro.ru; s=mail; t=1660043602; bh=0MZ8DE8uBlhpu1dZIIH/jtWE4oMfDh8Xlou6S2PyFyw=; h=Date:To:From:Subject; b=MH3IaEEWDptquyN3146kgqNroCLj0Urfo0za2lUhXTYT2SpPOudKeZIwit2+j7R4W DbcElzTMen13WD/IhvVZytIIlR9rEofLBy9LTcTINKtwNjF4nn5/OIpO5J3GhRKIOK 0vzMBGqJjuVFmkQxSJPQwfoShvjZuVZY1m23zQsk= Content-Type: multipart/mixed; boundary="------------PMWwim7jy0my04QXaaF5iHmh" Message-ID: <1a666b2e-d373-1c94-1005-1700e023670d@postgrespro.ru> Date: Tue, 9 Aug 2022 14:13:21 +0300 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Content-Language: en-US To: pgsql-docs@lists.postgresql.org From: Elena Indrupskaya Subject: Intro enhancement proposal List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk This is a multi-part message in MIME format. --------------PMWwim7jy0my04QXaaF5iHmh Content-Type: multipart/alternative; boundary="------------utpThvBFlyUlrpk0bombt370" --------------utpThvBFlyUlrpk0bombt370 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Hello, It occurred to me that adding some cross-references to intro.sgml could add value to the PostgreSQL 15 documentation through a possibility to immediately figure out what is meant by specific list items and through providing even better navigation. Details are in the attached patch. Thank you. -- Elena Indrupskaya Lead Technical Writer Postgres Professional http://www.postgrespro.com --------------utpThvBFlyUlrpk0bombt370 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit

Hello,

It occurred to me that adding some cross-references to intro.sgml could add value to the PostgreSQL 15 documentation through a possibility to immediately figure out what is meant by specific list items and through providing even better navigation. Details are in the attached patch.

Thank you.

--
Elena Indrupskaya
Lead Technical Writer
Postgres Professional http://www.postgrespro.com
--------------utpThvBFlyUlrpk0bombt370-- --------------PMWwim7jy0my04QXaaF5iHmh Content-Type: text/x-patch; charset=UTF-8; name="intro_doc_psql.patch" Content-Disposition: attachment; filename="intro_doc_psql.patch" Content-Transfer-Encoding: base64 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9pbnRyby5zZ21sIGIvZG9jL3NyYy9zZ21sL2lu dHJvLnNnbWwKaW5kZXggNjNlZGEwNTlmMC4uY2ZiZTA0NDc0NiAxMDA2NDQKLS0tIGEvZG9j L3NyYy9zZ21sL2ludHJvLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL2ludHJvLnNnbWwKQEAg LTEwMSwyMiArMTAxLDIyIEBACiAKICAgIDxpdGVtaXplZGxpc3Qgc3BhY2luZz0iY29tcGFj dCI+CiAgICAgPGxpc3RpdGVtPgotICAgICA8c2ltcGFyYT5jb21wbGV4IHF1ZXJpZXM8L3Np bXBhcmE+CisgICAgIDxzaW1wYXJhPjxsaW5rIGxpbmtlbmQ9InNxbCI+Y29tcGxleCBxdWVy aWVzPC9saW5rPjwvc2ltcGFyYT4KICAgICA8L2xpc3RpdGVtPgogICAgIDxsaXN0aXRlbT4K LSAgICAgPHNpbXBhcmE+Zm9yZWlnbiBrZXlzPC9zaW1wYXJhPgorICAgICA8c2ltcGFyYT48 bGluayBsaW5rZW5kPSJkZGwtY29uc3RyYWludHMtZmsiPmZvcmVpZ24ga2V5czwvbGluaz48 L3NpbXBhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgICA8bGlzdGl0ZW0+Ci0gICAgIDxzaW1w YXJhPnRyaWdnZXJzPC9zaW1wYXJhPgorICAgICA8c2ltcGFyYT48bGluayBsaW5rZW5kPSJ0 cmlnZ2VycyI+dHJpZ2dlcnM8L2xpbms+PC9zaW1wYXJhPgogICAgIDwvbGlzdGl0ZW0+CiAg ICAgPGxpc3RpdGVtPgotICAgICA8c2ltcGFyYT51cGRhdGFibGUgdmlld3M8L3NpbXBhcmE+ CisgICAgIDxzaW1wYXJhPjxsaW5rIGxpbmtlbmQ9InNxbC1jcmVhdGV2aWV3LXVwZGF0YWJs ZS12aWV3cyI+dXBkYXRhYmxlIHZpZXdzPC9saW5rPjwvc2ltcGFyYT4KICAgICA8L2xpc3Rp dGVtPgogICAgIDxsaXN0aXRlbT4KLSAgICAgPHNpbXBhcmE+dHJhbnNhY3Rpb25hbCBpbnRl Z3JpdHk8L3NpbXBhcmE+CisgICAgIDxzaW1wYXJhPjxsaW5rIGxpbmtlbmQ9InRyYW5zYWN0 aW9uLWlzbyI+dHJhbnNhY3Rpb25hbCBpbnRlZ3JpdHk8L2xpbms+PC9zaW1wYXJhPgogICAg IDwvbGlzdGl0ZW0+CiAgICAgPGxpc3RpdGVtPgotICAgICA8c2ltcGFyYT5tdWx0aXZlcnNp b24gY29uY3VycmVuY3kgY29udHJvbDwvc2ltcGFyYT4KKyAgICAgPHNpbXBhcmE+PGxpbmsg bGlua2VuZD0ibXZjYyI+bXVsdGl2ZXJzaW9uIGNvbmN1cnJlbmN5IGNvbnRyb2w8L2xpbms+ PC9zaW1wYXJhPgogICAgIDwvbGlzdGl0ZW0+CiAgICA8L2l0ZW1pemVkbGlzdD4KIApAQCAt MTI1LDIyICsxMjUsMjIgQEAKIAogICAgPGl0ZW1pemVkbGlzdCBzcGFjaW5nPSJjb21wYWN0 Ij4KICAgICA8bGlzdGl0ZW0+Ci0gICAgIDxzaW1wYXJhPmRhdGEgdHlwZXM8L3NpbXBhcmE+ CisgICAgIDxzaW1wYXJhPjxsaW5rIGxpbmtlbmQ9ImV4dGVuZC10eXBlLXN5c3RlbSI+ZGF0 YSB0eXBlczwvbGluaz48L3NpbXBhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgICA8bGlzdGl0 ZW0+Ci0gICAgIDxzaW1wYXJhPmZ1bmN0aW9uczwvc2ltcGFyYT4KKyAgICAgPHNpbXBhcmE+ PGxpbmsgbGlua2VuZD0ieGZ1bmMiPmZ1bmN0aW9uczwvbGluaz48L3NpbXBhcmE+CiAgICAg PC9saXN0aXRlbT4KICAgICA8bGlzdGl0ZW0+Ci0gICAgIDxzaW1wYXJhPm9wZXJhdG9yczwv c2ltcGFyYT4KKyAgICAgPHNpbXBhcmE+PGxpbmsgbGlua2VuZD0ieG9wZXIiPm9wZXJhdG9y czwvbGluaz48L3NpbXBhcmE+CiAgICAgPC9saXN0aXRlbT4KICAgICA8bGlzdGl0ZW0+Ci0g ICAgIDxzaW1wYXJhPmFnZ3JlZ2F0ZSBmdW5jdGlvbnM8L3NpbXBhcmE+CisgICAgIDxzaW1w YXJhPjxsaW5rIGxpbmtlbmQ9InhhZ2dyIj5hZ2dyZWdhdGUgZnVuY3Rpb25zPC9saW5rPjwv c2ltcGFyYT4KICAgICA8L2xpc3RpdGVtPgogICAgIDxsaXN0aXRlbT4KLSAgICAgPHNpbXBh cmE+aW5kZXggbWV0aG9kczwvc2ltcGFyYT4KKyAgICAgPHNpbXBhcmE+PGxpbmsgbGlua2Vu ZD0ieGluZGV4Ij5pbmRleCBtZXRob2RzPC9saW5rPjwvc2ltcGFyYT4KICAgICA8L2xpc3Rp dGVtPgogICAgIDxsaXN0aXRlbT4KLSAgICAgPHNpbXBhcmE+cHJvY2VkdXJhbCBsYW5ndWFn ZXM8L3NpbXBhcmE+CisgICAgIDxzaW1wYXJhPjxsaW5rIGxpbmtlbmQ9InhwbGFuZy1pbnN0 YWxsIj5wcm9jZWR1cmFsIGxhbmd1YWdlczwvbGluaz48L3NpbXBhcmE+CiAgICAgPC9saXN0 aXRlbT4KICAgIDwvaXRlbWl6ZWRsaXN0PgogICA8L3BhcmE+Cg== --------------PMWwim7jy0my04QXaaF5iHmh--