MIME-Version: 1.0
References: <c59ffbd5-96ac-a5a5-a401-14f627ca1405@postgresql.org>
In-Reply-To: <c59ffbd5-96ac-a5a5-a401-14f627ca1405@postgresql.org>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Sun, 6 Feb 2022 18:56:32 -0700
Message-ID: 
 <CAKFQuwZHCbKYpEKEoQe=4Vf7JxTwVLbZdiLt-W+QgJsBN7wkzw@mail.gmail.com>
Subject: Re: documentation on HOT
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Content-Type: multipart/alternative; boundary="000000000000db895f05d763e95c"
Archived-At: 
 <https://www.postgresql.org/message-id/CAKFQuwZHCbKYpEKEoQe%3D4Vf7JxTwVLbZdiLt-W%2BQgJsBN7wkzw%40mail.gmail.com>
Precedence: bulk

--000000000000db895f05d763e95c
Content-Type: text/plain; charset="UTF-8"

On Sun, Feb 6, 2022 at 6:08 PM Jonathan S. Katz <jkatz@postgresql.org>
wrote:

>
> Given the importance of HOT, it seems like this would be a good topic to
> document. I would suggest something higher-level for general users in
> the "Indexes"[4] section, and something lower-level in internals[5]
> (which could perhaps be derived from [2]).
>
> Thoughts on this?
>

I'm doubting there is any disagreement that this is needed.  Three of us
said as much recently [1] while discussing a user question regarding our
documentation for expression indexes.

[1]
https://www.postgresql.org/message-id/flat/CAKFQuwY2MAhXTpPNG9cBA135GAOPcZ0jK-QkqW8_VCGQDJXtjQ%40mail.gmail.com#1f060009bf7009b0d74cb9af042ccef7

I presently haven't felt moved to fill the need myself as so I was fine
with at least providing a high-level summary in the glossary which we also
the general user to understand the idea without having to dive into the
README.  The details for internals can continue to be handled there in the
interest of at least getting something committed for the majority of users.

David J.

--000000000000db895f05d763e95c
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div class=3D"gmail_default" style=3D"fon=
t-family:arial,helvetica,sans-serif"><span style=3D"font-family:Arial,Helve=
tica,sans-serif">On Sun, Feb 6, 2022 at 6:08 PM Jonathan S. Katz &lt;<a hre=
f=3D"mailto:jkatz@postgresql.org">jkatz@postgresql.org</a>&gt; wrote:</span=
><br></div></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quot=
e" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204)=
;padding-left:1ex"><br>
Given the importance of HOT, it seems like this would be a good topic to <b=
r>
document. I would suggest something higher-level for general users in <br>
the &quot;Indexes&quot;[4] section, and something lower-level in internals[=
5] <br>
(which could perhaps be derived from [2]).<br>
<br>
Thoughts on this?<br></blockquote><div><br></div><div><div class=3D"gmail_d=
efault" style=3D"font-family:arial,helvetica,sans-serif">I&#39;m doubting t=
here is any disagreement that this is needed.=C2=A0 Three of us said as muc=
h recently [1] while discussing a user question regarding our documentation=
 for expression indexes.</div><div class=3D"gmail_default" style=3D"font-fa=
mily:arial,helvetica,sans-serif"><br></div><div class=3D"gmail_default" sty=
le=3D"font-family:arial,helvetica,sans-serif">[1] <a href=3D"https://www.po=
stgresql.org/message-id/flat/CAKFQuwY2MAhXTpPNG9cBA135GAOPcZ0jK-QkqW8_VCGQD=
JXtjQ%40mail.gmail.com#1f060009bf7009b0d74cb9af042ccef7">https://www.postgr=
esql.org/message-id/flat/CAKFQuwY2MAhXTpPNG9cBA135GAOPcZ0jK-QkqW8_VCGQDJXtj=
Q%40mail.gmail.com#1f060009bf7009b0d74cb9af042ccef7</a></div><div class=3D"=
gmail_default" style=3D"font-family:arial,helvetica,sans-serif"><br></div><=
div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif=
">I presently haven&#39;t felt moved to fill=C2=A0the need myself as so I w=
as fine with at least providing a high-level summary in the glossary which =
we also the general user to understand the idea without having to dive into=
 the README.=C2=A0 The details for internals can continue to be handled the=
re in the interest of at least getting something committed for the majority=
 of users.</div><div class=3D"gmail_default" style=3D"font-family:arial,hel=
vetica,sans-serif"><br></div></div><div class=3D"gmail_default" style=3D"fo=
nt-family:arial,helvetica,sans-serif">David J.</div><div class=3D"gmail_def=
ault" style=3D"font-family:arial,helvetica,sans-serif"><br></div></div></di=
v>

--000000000000db895f05d763e95c--