RE: New "function tables" in V13 documentation

2020-11-16 Thread Kevin Brannen
>From: Adrian Klaver >>On 11/15/20 9:00 AM, David G. Johnston wrote: > >> In hindsight it could have been handled better. Waiting longer at >> different points and making pronouncements on -announce to solicit >> feedback from people who don't follow -docs. That doesn't change the > Yes and at

Re: New "function tables" in V13 documentation

2020-11-15 Thread Adrian Klaver
On 11/15/20 9:00 AM, David G. Johnston wrote: On Sun, Nov 15, 2020 at 9:39 AM Adrian Klaver > wrote: On 11/14/20 8:24 PM, David G. Johnston wrote: > On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver mailto:adrian.kla...@aklaver.com> >

Re: New "function tables" in V13 documentation

2020-11-15 Thread Adrian Klaver
On 11/14/20 8:24 PM, David G. Johnston wrote: On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver > wrote: Which is an indication that for changes of this scope it would be prudent to create a mock up and have end users see and comment on before

Re: New "function tables" in V13 documentation

2020-11-15 Thread David G. Johnston
On Sun, Nov 15, 2020 at 9:39 AM Adrian Klaver wrote: > On 11/14/20 8:24 PM, David G. Johnston wrote: > > On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver > > wrote: > > > > Which is an indication that for changes of this scope it would be > > prudent to

Re: New "function tables" in V13 documentation

2020-11-15 Thread Adrian Klaver
On 11/14/20 8:24 PM, David G. Johnston wrote: On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver > wrote: Which is an indication that for changes of this scope it would be prudent to create a mock up and have end users see and comment on before

Re: New "function tables" in V13 documentation

2020-11-14 Thread David G. Johnston
On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver wrote: > Which is an indication that for changes of this scope it would be > prudent to create a mock up and have end users see and comment on before > rolling them out. > There were mockups and people did provide comments. Do you have any concrete

RE: New "function tables" in V13 documentation

2020-11-13 Thread Kevin Brannen
>From: David G. Johnston >>On Fri, Nov 13, 2020 at 12:20 PM Kevin Brannen >>wrote: >>Designing pages to the smallest media just frustrates those users on larger >>media (cue the many examples on the web where the left/right margins are so >>wide half of your

Re: New "function tables" in V13 documentation

2020-11-13 Thread Adrian Klaver
On 11/13/20 11:30 AM, David G. Johnston wrote: On Fri, Nov 13, 2020 at 12:20 PM Kevin Brannen > wrote: Go to the string funcs/ops page in v13, and try to quickly find the ones that return an "int" (because your goal is to find the position of something in a

Re: New "function tables" in V13 documentation

2020-11-13 Thread Adrian Klaver
On 11/13/20 11:20 AM, Kevin Brannen wrote: From: David G. Johnston On Mon, Nov 9, 2020 at 1:41 PM Tom Lane wrote: Alvaro Herrera writes: On 2020-Nov-08, Adrian Klaver wrote: Yeah, I would agree with the mobile first design

Re: New "function tables" in V13 documentation

2020-11-13 Thread David G. Johnston
On Fri, Nov 13, 2020 at 12:20 PM Kevin Brannen wrote: > Go to the string funcs/ops page in v13, and try to quickly find the ones > that return an "int" (because your goal is to find the position of > something in a string so you know the return value will have to be an > "int"). > That is not

RE: New "function tables" in V13 documentation

2020-11-13 Thread Kevin Brannen
>From: David G. Johnston >On Mon, Nov 9, 2020 at 1:41 PM Tom Lane wrote: >Alvaro Herrera writes: >> On 2020-Nov-08, Adrian Klaver wrote: >>> Yeah, I would agree with the mobile first design comments. Then again that >>> plague is

Re: New "function tables" in V13 documentation

2020-11-11 Thread Bruce Momjian
On Mon, Nov 9, 2020 at 07:46:21PM -0600, Merlin Moncure wrote: > On Sun, Nov 8, 2020 at 3:57 PM Thomas Kellerer wrote: > > > > In case someone is interested: there is a little discussion going on on > > Reddit whether the new format of presenting functions in V13 is a step > > backwards: > > >

Re: New "function tables" in V13 documentation

2020-11-09 Thread Merlin Moncure
On Sun, Nov 8, 2020 at 3:57 PM Thomas Kellerer wrote: > > In case someone is interested: there is a little discussion going on on > Reddit whether the new format of presenting functions in V13 is a step > backwards: > > >

Re: New "function tables" in V13 documentation

2020-11-09 Thread David G. Johnston
On Mon, Nov 9, 2020 at 3:30 PM Ron wrote: > On 11/9/20 3:05 PM, David G. Johnston wrote: > > On Mon, Nov 9, 2020 at 2:01 PM Ron wrote: > >> My suggestion is to add a "table of contents" at the top of non-trivial >> sections that simply lists available functions by name (generally ignoring >>

Re: New "function tables" in V13 documentation

2020-11-09 Thread Ron
On 11/9/20 3:05 PM, David G. Johnston wrote: On Mon, Nov 9, 2020 at 2:01 PM Ron > wrote: My suggestion is to add a "table of contents" at the top of non-trivial sections that simply lists available functions by name (generally ignoring argument

Re: New "function tables" in V13 documentation

2020-11-09 Thread David G. Johnston
On Mon, Nov 9, 2020 at 2:01 PM Ron wrote: > My suggestion is to add a "table of contents" at the top of non-trivial > sections that simply lists available functions by name (generally ignoring > argument variations) and a quick one line description of purpose. Once a > person finds the name of

Re: New "function tables" in V13 documentation

2020-11-09 Thread Ron
On 11/9/20 2:47 PM, David G. Johnston wrote: On Mon, Nov 9, 2020 at 1:41 PM Tom Lane > wrote: Alvaro Herrera mailto:alvhe...@alvh.no-ip.org>> writes: > On 2020-Nov-08, Adrian Klaver wrote: >> Yeah, I would agree with the mobile first design comments. Then

Re: New "function tables" in V13 documentation

2020-11-09 Thread Tom Lane
=?UTF-8?B?Sm9zZWYgxaBpbcOhbmVr?= writes: > But it is not clear for me what exactly was the problem with the old > format. Is there any discussion anyone can point me to to ensure I'll > not just revive the old problems, but improve the overall situation? The primary discussion threads for this

Re: New "function tables" in V13 documentation

2020-11-09 Thread Adrian Klaver
On 11/9/20 12:35 PM, Alvaro Herrera wrote: On 2020-Nov-09, Adrian Klaver wrote: If you have suggestion on how to improve the new format, I'm sure we can discuss that. It seems pretty clear to me that we're not going back to the old format. Improve it by going back to old format. Not sure

Re: New "function tables" in V13 documentation

2020-11-09 Thread David G. Johnston
On Mon, Nov 9, 2020 at 1:41 PM Tom Lane wrote: > Alvaro Herrera writes: > > On 2020-Nov-08, Adrian Klaver wrote: > >> Yeah, I would agree with the mobile first design comments. Then again > that > >> plague is hitting most sites these days. My 2 cents is it is a step > >> backwards. You can

Re: New "function tables" in V13 documentation

2020-11-09 Thread Tom Lane
Alvaro Herrera writes: > On 2020-Nov-08, Adrian Klaver wrote: >> Yeah, I would agree with the mobile first design comments. Then again that >> plague is hitting most sites these days. My 2 cents is it is a step >> backwards. You can cover more ground quickly and digest it faster in the old >>

Re: New "function tables" in V13 documentation

2020-11-09 Thread Josef Šimánek
po 9. 11. 2020 v 21:35 odesílatel Alvaro Herrera napsal: > > On 2020-Nov-09, Adrian Klaver wrote: > > > > If you have suggestion on how to improve the new format, I'm sure we can > > > discuss that. It seems pretty clear to me that we're not going back to > > > the old format. > > > > Improve it

Re: New "function tables" in V13 documentation

2020-11-09 Thread David G. Johnston
On Mon, Nov 9, 2020 at 1:33 PM Adrian Klaver wrote: > On 11/9/20 12:06 PM, Alvaro Herrera wrote: > > > If you have suggestion on how to improve the new format, I'm sure we can > > discuss that. It seems pretty clear to me that we're not going back to > > the old format. > > Improve it by going

Re: New "function tables" in V13 documentation

2020-11-09 Thread Alvaro Herrera
On 2020-Nov-09, Adrian Klaver wrote: > > If you have suggestion on how to improve the new format, I'm sure we can > > discuss that. It seems pretty clear to me that we're not going back to > > the old format. > > Improve it by going back to old format. Not sure why that is not open to >

Re: New "function tables" in V13 documentation

2020-11-09 Thread Adrian Klaver
On 11/9/20 12:06 PM, Alvaro Herrera wrote: On 2020-Nov-08, Adrian Klaver wrote: On 11/8/20 1:57 PM, Thomas Kellerer wrote: In case someone is interested: there is a little discussion going on on Reddit whether the new format of presenting functions in V13 is a step backwards:

Re: New "function tables" in V13 documentation

2020-11-09 Thread Alvaro Herrera
On 2020-Nov-08, Adrian Klaver wrote: > On 11/8/20 1:57 PM, Thomas Kellerer wrote: > > In case someone is interested: there is a little discussion going on on > > Reddit whether the new format of presenting functions in V13 is a step > > backwards: > > > > > >

Re: New "function tables" in V13 documentation

2020-11-09 Thread Tony Shelver
On Mon, 9 Nov 2020 at 02:54, Adrian Klaver wrote: > On 11/8/20 1:57 PM, Thomas Kellerer wrote: > > In case someone is interested: there is a little discussion going on on > > Reddit whether the new format of presenting functions in V13 is a step > > backwards: > > > > > > >

Re: New "function tables" in V13 documentation

2020-11-08 Thread Adrian Klaver
On 11/8/20 1:57 PM, Thomas Kellerer wrote: In case someone is interested: there is a little discussion going on on Reddit whether the new format of presenting functions in V13 is a step backwards: