Re: fix old confusing JSON example

From: Erik Rijkers <er(at)xs4all(dot)nl>
To: Michael Paquier <michael(at)paquier(dot)xyz>
Cc: "pgsql-hackers(at)lists(dot)postgresql(dot)org" <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: fix old confusing JSON example
Date: 2021-04-20 19:07:52
Message-ID: 1262514661.622692.1618945673016@webmailclassic.xs4all.nl
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers

> On 2021.04.16. 10:00 Michael Paquier <michael(at)paquier(dot)xyz> wrote:
> On Sat, Apr 03, 2021 at 02:28:38PM +0200, Erik Rijkers wrote:
> > So, that gives information on two operators, and then gives one
> > example query for each. Clearly, the second example was meant to
> > illustrate a where-clause with the @? operator.
> >
> > Small change to prevent great confusion (I'll admit it took me far
> > too long to understand this).
>
> Once one guesses the definition of the table to use with the sample
> data at disposal in the docs, it is easy to see that both queries
> should return the same result, but the second one misses the shot and
> is corrected as you say. So, applied.

Great, thank you.

I just happened to use the website-documentation and noticed that there the change is not done: it still has the erroneous line, in the docs of 13 (current), and 12; the docs of 14devel are apparently updated.

That makes me wonder: is there a regular html-docs-update (dayly? weekly?) of doc-bugs of this kind in the website-docs of current and earlier releases?

To be clear, I am talking about the lines below:
'GIN index supports @@ and @? operators'

on pages
https://www.postgresql.org/docs/13/datatype-json.html
https://www.postgresql.org/docs/12/datatype-json.html

where the change that was pushed was to correct the second example from @@ to @?

thanks,

Erik Rijkers

>
> My apologies for the delay.
> --
> Michael

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Justin Pryzby 2021-04-20 19:44:28 Re: fix old confusing JSON example
Previous Message Bruce Momjian 2021-04-20 16:58:10 pgsql: Fix interaction of log_line_prefix's query_id and log_statement

Browse pgsql-docs by date

  From Date Subject
Next Message Justin Pryzby 2021-04-20 19:44:28 Re: fix old confusing JSON example
Previous Message David G. Johnston 2021-04-20 13:17:09 Re: regarding stored procedure

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Geoghegan 2021-04-20 19:24:29 Re: ML-based indexing ("The Case for Learned Index Structures", a paper from Google)
Previous Message Stephen Frost 2021-04-20 19:04:59 Re: when the startup process doesn't