Content-Type: multipart/mixed; boundary="------------K1pmOuxlOhciBz1DaYGuQh4X"
Message-ID: <5fcda2fa-fb49-41f2-a5e5-c3100937b0a4@postgrespro.ru>
Date: Tue, 16 Apr 2024 11:48:07 +0300
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: three small improvements for "Composite Types" page
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: pgsql-docs <pgsql-docs@lists.postgresql.org>
References: <38aa8e65-32e2-4578-bfc8-0d9f59efe049@postgrespro.ru>
 <CAKFQuwaKuYy9XhszEsfhZOzeKjKcxvG++e+dTAHSUtEOHf4BMA@mail.gmail.com>
Content-Language: en-US
From: Anton Voloshin <a.voloshin@postgrespro.ru>
In-Reply-To: 
 <CAKFQuwaKuYy9XhszEsfhZOzeKjKcxvG++e+dTAHSUtEOHf4BMA@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/5fcda2fa-fb49-41f2-a5e5-c3100937b0a4%40postgrespro.ru>
Precedence: bulk

This is a multi-part message in MIME format.
--------------K1pmOuxlOhciBz1DaYGuQh4X
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

On 12/04/2024 23:44, David G. Johnston wrote:
> I'd much prefer to leave "different kind" alone and turn the immediately 
> following, first-on-the-page, instance of CREATE TYPE into a link.

Good, I'm fine with that too.

>   2. make first mention of CREATE TABLE a link
> [...] > I'm not all that convinced of that particular usefulness but also don't
> see it hurting either.

Thanks. I do think it's useful when one reads this page separately (not 
as a part of sequential read-through).

>     3. Simplify CREATE TABLE example to make it self-sufficient
> [...]
> Agreed.

Thanks. I've updated the patches correspondingly.

-- 
Anton Voloshin
Postgres Professional, The Russian Postgres Company
https://postgrespro.ru
--------------K1pmOuxlOhciBz1DaYGuQh4X
Content-Type: text/x-patch; charset=UTF-8;
 name="0001-Composite-Types-clarify-different-kind-by-linking-to.patch"
Content-Disposition: attachment;
 filename*0="0001-Composite-Types-clarify-different-kind-by-linking-to.pa";
 filename*1="tch"
Content-Transfer-Encoding: base64

RnJvbSBkZGRmN2VlNGE5YTIyNTE1YzMyNzQzNGI3ZGIyYzAyOTMzMDFiMjU3IE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBBbnRvbiBWb2xvc2hpbiA8YS52b2xvc2hpbkBwb3N0
Z3Jlc3Byby5ydT4KRGF0ZTogRnJpLCAxMiBBcHIgMjAyNCAyMjo0OToxNyArMDMwMApTdWJq
ZWN0OiBbUEFUQ0ggMS8zXSBDb21wb3NpdGUgVHlwZXM6IGNsYXJpZnkgImRpZmZlcmVudCBr
aW5kIiBieSBsaW5raW5nIHRvIGEKICJjcmVhdGUgdHlwZSIgcGFnZQoKLS0tCiBkb2Mvc3Jj
L3NnbWwvcm93dHlwZXMuc2dtbCB8IDIgKy0KIDEgZmlsZSBjaGFuZ2VkLCAxIGluc2VydGlv
bigrKSwgMSBkZWxldGlvbigtKQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9yb3d0eXBl
cy5zZ21sIGIvZG9jL3NyYy9zZ21sL3Jvd3R5cGVzLnNnbWwKaW5kZXggYmJlYWM4NGQ0NmEu
LjA0OWU5MGU5YzY4IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dtbAor
KysgYi9kb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dtbApAQCAtNDAsNyArNDAsNyBAQCBDUkVB
VEUgVFlQRSBpbnZlbnRvcnlfaXRlbSBBUyAoCiAgIGZpZWxkIG5hbWVzIGFuZCB0eXBlcyBj
YW4gYmUgc3BlY2lmaWVkOyBubyBjb25zdHJhaW50cyAoc3VjaCBhcyA8bGl0ZXJhbD5OT1QK
ICAgTlVMTDwvbGl0ZXJhbD4pIGNhbiBwcmVzZW50bHkgYmUgaW5jbHVkZWQuICBOb3RlIHRo
YXQgdGhlIDxsaXRlcmFsPkFTPC9saXRlcmFsPiBrZXl3b3JkCiAgIGlzIGVzc2VudGlhbDsg
d2l0aG91dCBpdCwgdGhlIHN5c3RlbSB3aWxsIHRoaW5rIGEgZGlmZmVyZW50IGtpbmQKLSAg
b2YgPGNvbW1hbmQ+Q1JFQVRFIFRZUEU8L2NvbW1hbmQ+IGNvbW1hbmQgaXMgbWVhbnQsIGFu
ZCB5b3Ugd2lsbCBnZXQgb2RkIHN5bnRheAorICBvZiA8eHJlZiBsaW5rZW5kPSJzcWwtY3Jl
YXRldHlwZSIvPiBjb21tYW5kIGlzIG1lYW50LCBhbmQgeW91IHdpbGwgZ2V0IG9kZCBzeW50
YXgKICAgZXJyb3JzLgogIDwvcGFyYT4KIAotLSAKMi40My4yCgo=
--------------K1pmOuxlOhciBz1DaYGuQh4X
Content-Type: text/x-patch; charset=UTF-8;
 name="0002-Composite-Types-make-first-mention-of-CREATE-TABLE-a.patch"
Content-Disposition: attachment;
 filename*0="0002-Composite-Types-make-first-mention-of-CREATE-TABLE-a.pa";
 filename*1="tch"
Content-Transfer-Encoding: base64

RnJvbSBkZWYzZjdjY2I1NWI0NGU2M2IyYTlmZmZhODhiYTRkM2M1NDVlNTUzIE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBBbnRvbiBWb2xvc2hpbiA8YS52b2xvc2hpbkBwb3N0
Z3Jlc3Byby5ydT4KRGF0ZTogRnJpLCAxMiBBcHIgMjAyNCAyMjo1NjoxOCArMDMwMApTdWJq
ZWN0OiBbUEFUQ0ggMi8zXSBDb21wb3NpdGUgVHlwZXM6IG1ha2UgZmlyc3QgbWVudGlvbiBv
ZiBDUkVBVEUgVEFCTEUgYQogbGluawoKLS0tCiBkb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dt
bCB8IDIgKy0KIDEgZmlsZSBjaGFuZ2VkLCAxIGluc2VydGlvbigrKSwgMSBkZWxldGlvbigt
KQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9yb3d0eXBlcy5zZ21sIGIvZG9jL3NyYy9z
Z21sL3Jvd3R5cGVzLnNnbWwKaW5kZXggMDQ5ZTkwZTljNjguLmE0MDliMjkyNzk1IDEwMDY0
NAotLS0gYS9kb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwv
cm93dHlwZXMuc2dtbApAQCAtMzYsNyArMzYsNyBAQCBDUkVBVEUgVFlQRSBpbnZlbnRvcnlf
aXRlbSBBUyAoCiAgICAgcHJpY2UgICAgICAgICAgIG51bWVyaWMKICk7CiA8L3Byb2dyYW1s
aXN0aW5nPgotICBUaGUgc3ludGF4IGlzIGNvbXBhcmFibGUgdG8gPGNvbW1hbmQ+Q1JFQVRF
IFRBQkxFPC9jb21tYW5kPiwgZXhjZXB0IHRoYXQgb25seQorICBUaGUgc3ludGF4IGlzIGNv
bXBhcmFibGUgdG8gPHhyZWYgbGlua2VuZD0ic3FsLWNyZWF0ZXRhYmxlIi8+LCBleGNlcHQg
dGhhdCBvbmx5CiAgIGZpZWxkIG5hbWVzIGFuZCB0eXBlcyBjYW4gYmUgc3BlY2lmaWVkOyBu
byBjb25zdHJhaW50cyAoc3VjaCBhcyA8bGl0ZXJhbD5OT1QKICAgTlVMTDwvbGl0ZXJhbD4p
IGNhbiBwcmVzZW50bHkgYmUgaW5jbHVkZWQuICBOb3RlIHRoYXQgdGhlIDxsaXRlcmFsPkFT
PC9saXRlcmFsPiBrZXl3b3JkCiAgIGlzIGVzc2VudGlhbDsgd2l0aG91dCBpdCwgdGhlIHN5
c3RlbSB3aWxsIHRoaW5rIGEgZGlmZmVyZW50IGtpbmQKLS0gCjIuNDMuMgoK
--------------K1pmOuxlOhciBz1DaYGuQh4X
Content-Type: text/x-patch; charset=UTF-8;
 name="0003-Composite-Types-simplify-CREATE-TABLE-example-to-mak.patch"
Content-Disposition: attachment;
 filename*0="0003-Composite-Types-simplify-CREATE-TABLE-example-to-mak.pa";
 filename*1="tch"
Content-Transfer-Encoding: base64

RnJvbSBiYmRhNmEyMGEzODdjZDZiMTM3OWI3NjBkZTBlMjE1ODUxZTYzOGE5IE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBBbnRvbiBWb2xvc2hpbiA8YS52b2xvc2hpbkBwb3N0
Z3Jlc3Byby5ydT4KRGF0ZTogRnJpLCAxMiBBcHIgMjAyNCAyMjo1ODo0NSArMDMwMApTdWJq
ZWN0OiBbUEFUQ0ggMy8zXSBDb21wb3NpdGUgVHlwZXM6IHNpbXBsaWZ5IENSRUFURSBUQUJM
RSBleGFtcGxlIHRvIG1ha2UgaXQKIHNlbGYtc3VmZmljaWVudAoKLS0tCiBkb2Mvc3JjL3Nn
bWwvcm93dHlwZXMuc2dtbCB8IDIgKy0KIDEgZmlsZSBjaGFuZ2VkLCAxIGluc2VydGlvbigr
KSwgMSBkZWxldGlvbigtKQoKZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9yb3d0eXBlcy5z
Z21sIGIvZG9jL3NyYy9zZ21sL3Jvd3R5cGVzLnNnbWwKaW5kZXggYTQwOWIyOTI3OTUuLmI2
MDYzYjMwYzMxIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dtbAorKysg
Yi9kb2Mvc3JjL3NnbWwvcm93dHlwZXMuc2dtbApAQCAtNzQsNyArNzQsNyBAQCBTRUxFQ1Qg
cHJpY2VfZXh0ZW5zaW9uKGl0ZW0sIDEwKSBGUk9NIG9uX2hhbmQ7CiA8cHJvZ3JhbWxpc3Rp
bmc+CiBDUkVBVEUgVEFCTEUgaW52ZW50b3J5X2l0ZW0gKAogICAgIG5hbWUgICAgICAgICAg
ICB0ZXh0LAotICAgIHN1cHBsaWVyX2lkICAgICBpbnRlZ2VyIFJFRkVSRU5DRVMgc3VwcGxp
ZXJzLAorICAgIHN1cHBsaWVyX2lkICAgICBpbnRlZ2VyLAogICAgIHByaWNlICAgICAgICAg
ICBudW1lcmljIENIRUNLIChwcmljZSAmZ3Q7IDApCiApOwogPC9wcm9ncmFtbGlzdGluZz4K
LS0gCjIuNDMuMgoK

--------------K1pmOuxlOhciBz1DaYGuQh4X--