Re: Please provide examples of rows from

2020-09-29 Thread David G. Johnston
On Thu, Sep 24, 2020 at 12:37 PM Bruce Momjian wrote: > On Thu, Sep 24, 2020 at 03:05:24PM -0400, Tom Lane wrote: > > Bruce Momjian writes: > > > Yes, this is very helpful. I was afraid the JSON would overwhelm the > > > example, but this looks good. I wrote the attached doc patch which I > >

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Tom Lane
"Jonathan S. Katz" writes: > On 9/29/20 3:00 PM, Tom Lane wrote: >> But I think it's a net benefit for HTML output as well, in that the >> output does adapt much better than before to smaller window sizes. >> Not everybody wants to dedicate their whole screen to Postgres docs. > I'll also note it

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Daniel Gustafsson
> On 29 Sep 2020, at 21:09, Jonathan S. Katz wrote: > If there is something that in a defined way is hampering usability, then > we should address it, There is the issue with screen readers which was reported in [0], but that thread stalled. I have it on my TODO still to try out the multi-level

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Jonathan S. Katz
On 9/29/20 3:00 PM, Tom Lane wrote: > Niels Andersen writes: >> 2. Is there a middle ground? >> * Version 12 had 6 columns, version 13 has one. >> * Could we have fewer columns? What if we had 3 columns: One for >> operator or function, one for the details and description, and on

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Tom Lane
Niels Andersen writes: > 2. Is there a middle ground? > * Version 12 had 6 columns, version 13 has one. > * Could we have fewer columns? What if we had 3 columns: One for > operator or function, one for the details and description, and one for an > example with the results. A l

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Bruce Momjian
On Tue, Sep 29, 2020 at 09:52:31AM -0400, Tom Lane wrote: > PG Doc comments form writes: > > Compare: > > * https://www.postgresql.org/docs/13/functions-json.html > > * https://www.postgresql.org/docs/12/functions-json.html > > > I know it is just my opinion, but the version 12 layout is easier t

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Pavel Stehule
út 29. 9. 2020 v 16:32 odesílatel Pavel Stehule napsal: > > > út 29. 9. 2020 v 16:29 odesílatel Tom Lane napsal: > >> Pavel Stehule writes: >> > the new layout is probably better, but I miss some gentle separation of >> > these three parts - maybe using a different font? >> >> Hm? If you mean

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Pavel Stehule
út 29. 9. 2020 v 16:29 odesílatel Tom Lane napsal: > Pavel Stehule writes: > > the new layout is probably better, but I miss some gentle separation of > > these three parts - maybe using a different font? > > Hm? If you mean synopsis vs. description vs. examples, the description > already is a

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Tom Lane
Pavel Stehule writes: > the new layout is probably better, but I miss some gentle separation of > these three parts - maybe using a different font? Hm? If you mean synopsis vs. description vs. examples, the description already is a different font from the other two. I recall that we did experim

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Pavel Stehule
út 29. 9. 2020 v 15:52 odesílatel Tom Lane napsal: > PG Doc comments form writes: > > Compare: > > * https://www.postgresql.org/docs/13/functions-json.html > > * https://www.postgresql.org/docs/12/functions-json.html > > > I know it is just my opinion, but the version 12 layout is easier to read

Re: Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread Tom Lane
PG Doc comments form writes: > Compare: > * https://www.postgresql.org/docs/13/functions-json.html > * https://www.postgresql.org/docs/12/functions-json.html > I know it is just my opinion, but the version 12 layout is easier to read > than version 13. IMO, table 9.47 (JSON Processing Functions)

Version 13 documentation layout is harder to read than version 12

2020-09-29 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/13/functions-json.html Description: Compare: * https://www.postgresql.org/docs/13/functions-json.html * https://www.postgresql.org/docs/12/functions-json.html I know it is just my opinion, b