MIME-Version: 1.0
References: <20200402222639.GI14618@telsasoft.com>
 <20200403164513.GA25722@alvherre.pgsql>
In-Reply-To: <20200403164513.GA25722@alvherre.pgsql>
From: Corey Huinker <corey.huinker@gmail.com>
Date: Fri, 3 Apr 2020 13:34:17 -0400
Message-ID: 
 <CADkLM=d6+ePZ-pb1Dsftc-HrtGqqMT+iM4DWV=V-fZ+bKv_KQA@mail.gmail.com>
Subject: Re: Add A Glossary
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Justin Pryzby <pryzby@telsasoft.com>,
 =?UTF-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de>,
	Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
	Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
Content-Type: multipart/alternative; boundary="0000000000006f51d305a26654b2"
Precedence: bulk

--0000000000006f51d305a26654b2
Content-Type: text/plain; charset="UTF-8"

>
> we have it, we can start thinking of patching the main part of the docs
> to make reference to it by using <glossterm> in key spots.  Right now
> the glossary links to itself, but it makes lots of sense to have other
> places point to it.
>

I have some ideas about how to patch the main docs, but will leave those to
a separate thread.


> * I commented out the definition of "sequence", which seemed to go into
>   excessive detail.  Let's have a more concise definition?
>

That one's my fault.


>
> Patches for these omissions, and other contributions, welcome.
>

Thanks for all your work on this!

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

<div dir=3D"ltr"><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">we have it, we can start thinking of patching the main p=
art of the docs<br>
to make reference to it by using &lt;glossterm&gt; in key spots.=C2=A0 Righ=
t now<br>
the glossary links to itself, but it makes lots of sense to have other<br>
places point to it.<br></blockquote><div><br></div><div>I have some ideas a=
bout how to patch=C2=A0the main docs, but will leave those to a separate th=
read.</div><div>=C2=A0</div><blockquote class=3D"gmail_quote" style=3D"marg=
in:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1e=
x">* I commented out the definition of &quot;sequence&quot;, which seemed t=
o go into<br>
=C2=A0 excessive detail.=C2=A0 Let&#39;s have a more concise definition?<br=
></blockquote><div><br></div><div>That one&#39;s my fault.=C2=A0</div><div>=
=C2=A0<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0=
px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">

<br>
Patches for these omissions, and other contributions, welcome.<br></blockqu=
ote><div><br></div><div>Thanks for all your work on this!=C2=A0</div></div>=
</div>

--0000000000006f51d305a26654b2--