Re: Index / glossary adjustments for Git & GUC

From: Fujii Masao <masao(dot)fujii(at)gmail(dot)com>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: Robert Treat <rob(at)xzilla(dot)net>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Index / glossary adjustments for Git & GUC
Date: 2025-08-14 02:48:14
Message-ID: CAHGQGwETTsf8ZFKWO3aVu-b6bQuNLS5PT2qx7NaxYMz-U2b1nA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, Aug 13, 2025 at 5:04 PM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
>
> > On 13 Aug 2025, at 01:16, Robert Treat <rob(at)xzilla(dot)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="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 (LSN)"
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,

--
Fujii Masao

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Fujii Masao 2025-08-14 02:49:32 Re: Index / glossary adjustments for Git & GUC
Previous Message Tom Lane 2025-08-13 22:50:25 Re: Tutorial from Chapter 2.1