Re: [DOCS] Confusing Trigger Docs.

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: Peter Geoghegan <pg(at)bowt(dot)ie>, neil(at)fairwindsoft(dot)com, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>, Andres Freund <andres(at)anarazel(dot)de>, Heikki Linnakangas <heikki(dot)linnakangas(at)iki(dot)fi>
Subject: Re: [DOCS] Confusing Trigger Docs.
Date: 2023-12-08 02:36:13
Message-ID: ZXKBHfN1OozOaR9K@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sun, Nov 26, 2023 at 08:59:02PM +0100, Laurenz Albe wrote:
> On Fri, 2023-11-24 at 13:14 -0500, Bruce Momjian wrote:
> > On Thu, Nov 23, 2023 at 08:36:34AM +0100, Laurenz Albe wrote:
> > > On Wed, 2023-11-22 at 14:49 -0800, Peter Geoghegan wrote:
> > > > I don't think that your proposed wording for this is an improvement.
> > >
> > > Well, the existing wording is impenetrable even for someone with some
> > > PostgreSQL knowledge, like me.
> >
> > I moved the partition paragraph to a more logical location and tried to
> > clarify the new paragraph to be more targeted on the goal, patch
> > attached.
>
> I cannot tell if that covers everything that the original text (which
> I failed to understand) did, but your wording makes sense to me.

Patch applied to master. It doesn't have everything that the previous
docs had, but I considered that an improvement.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-12-08 04:05:15 Inconsistent information on default ordering for ORDER BY clause
Previous Message Bruce Momjian 2023-12-08 00:43:17 Re: SELECT ... FOR UPDATE OF clause documentation implies use of table_names rather than aliases