Re: JSON Functions and Operators Docs for v15 - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: JSON Functions and Operators Docs for v15
Date
Msg-id CAKFQuwbgw5EJL13xSWVUBYFXQSDXdQW48-heXT_TG-wVY0ZmrQ@mail.gmail.com
Whole thread Raw
In response to Re: JSON Functions and Operators Docs for v15  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Wed, May 4, 2022 at 8:39 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
"David G. Johnston" <david.g.johnston@gmail.com> writes:
> Is there a thread I'm not finding where the upcoming JSON function
> documentation is being made reasonably usable after doubling its size with
> all the new JSON Table features that we've added?  If nothing else, the
> table of contents at the top of the page needs to be greatly expanded to
> make seeing and navigating to all that is available a possibility.

The entire structure of that text needs to be rethought, IMO, as it
has been written with precisely no concern for fitting into our
hard-won structure for func.sgml.  Andrew muttered something about
rewriting it awhile ago, but I don't know what progress he's made.


I suppose regardless of the answer, or which thread is used for the patch, the question at hand is whether this is problematic enough to warrant an open item.  I would lean toward yes, we can decide how much reworking is considered sufficient to clear the open item separately.

David J.

pgsql-hackers by date:

Previous
From: Justin Pryzby
Date:
Subject: Re: JSON Functions and Operators Docs for v15
Next
From: Peter Eisentraut
Date:
Subject: Re: automatically generating node support functions