MIME-Version: 1.0
References: 
 <CABV9wwPQnkeo_G6-orMGnHPK9SXGVWm7ajJPzsbE6944tDx=hQ@mail.gmail.com>
 <FFBAE5D1-F0E6-4983-80B3-82FF0B1CF6F5@yesql.se>
In-Reply-To: <FFBAE5D1-F0E6-4983-80B3-82FF0B1CF6F5@yesql.se>
From: Fujii Masao <masao.fujii@gmail.com>
Date: Thu, 14 Aug 2025 11:48:14 +0900
Message-ID: 
 <CAHGQGwETTsf8ZFKWO3aVu-b6bQuNLS5PT2qx7NaxYMz-U2b1nA@mail.gmail.com>
Subject: Re: Index / glossary adjustments for Git & GUC
To: Daniel Gustafsson <daniel@yesql.se>
Cc: Robert Treat <rob@xzilla.net>, pgsql-docs@lists.postgresql.org
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Archived-At: 
 <https://www.postgresql.org/message-id/CAHGQGwETTsf8ZFKWO3aVu-b6bQuNLS5PT2qx7NaxYMz-U2b1nA%40mail.gmail.com>
Precedence: bulk

On Wed, Aug 13, 2025 at 5:04=E2=80=AFPM Daniel Gustafsson <daniel@yesql.se>=
 wrote:
>
> > On 13 Aug 2025, at 01:16, Robert Treat <rob@xzilla.net> wrote:
>
> > The first patch removes the term "Git" from the acronyms section and
> > instead creates an index entry that points to our source repository
> > information.
>
> This was previously discussed in this thread:
>
> https://postgr.es/m/8241CED6-F408-4660-A1AA-F3393AA26219%40yesql.se
>
> > For the second, ISTM we use the term GUC to refer to parameters pretty
> > liberally, but the term is not that easy to find in the docs (and
> > website search gives what is probably the best answer as result #7 of
> > 8). This creates an index entry for the term, as well as a glossary
> > entry which explains how it is commonly used.
>
> This seems like a good idea.

+1

+  <glossentry id=3D"glossary-guc">
+   <glossterm>GUC</glossterm>

Should we also include the full term "Grand Unified Configuration" here, e.=
g.,
"Grand unified configuration (GUC)", similar to how "Log sequence number (L=
SN)"
is shown in the glossary? Even though it's already in the acronyms docs,
it might be helpful to include it in the glossary as well.

Regards,

--=20
Fujii Masao