Re: Index / glossary adjustments for Git & GUC - Mailing list pgsql-docs

From Robert Treat
Subject Re: Index / glossary adjustments for Git & GUC
Date
Msg-id CAJSLCQ2iU3uEkPa1Ste4u-Lm574Z20+xy4TnDnXvrLrKkG44fg@mail.gmail.com
Whole thread Raw
In response to Re: Index / glossary adjustments for Git & GUC  (Robert Treat <rob@xzilla.net>)
List pgsql-docs
On Fri, Aug 15, 2025 at 12:12 AM Robert Treat <rob@xzilla.net> wrote:
> On Wed, Aug 13, 2025 at 10:48 PM Fujii Masao <masao.fujii@gmail.com> wrote:
> > On Wed, Aug 13, 2025 at 5:04 PM 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="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.
> >
>

Howdy folks,

While doing some end of year clean up, I noticed I hadn't followed up
on this thread, so attached is an updated set of patches, the first of
which adds the index entry for git, and the second which adds the
glossary entry for GUC, both in accordance with the above feedback.


Robert Treat
https://xzilla.net

Attachment

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: clarification for pg_basebackup and major versions
Next
From: Robert Treat
Date:
Subject: Fix improper xreflabels created for v18 release notes