From: | Ron <ronljohnsonjr(at)gmail(dot)com> |
---|---|
To: | "pgsql-generallists(dot)postgresql(dot)org" <pgsql-general(at)lists(dot)postgresql(dot)org> |
Subject: | Re: New "function tables" in V13 documentation |
Date: | 2020-11-09 22:30:13 |
Message-ID: | bfa3a77a-4709-1919-d7fb-f0d26ff44bea@gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-general |
On 11/9/20 3:05 PM, David G. Johnston wrote:
> On Mon, Nov 9, 2020 at 2:01 PM Ron <ronljohnsonjr(at)gmail(dot)com
> <mailto:ronljohnsonjr(at)gmail(dot)com>> 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 the function
>> that suits their needs they can then reference the main table for
>> details, warnings, and examples.
>
> This is what TOCs are for, no?
>
>
> Are you criticizing my over-explanation of the phrase "table of contents"
> here?
Why do you think that?
I'm *agreeing* this is why TOCs were invented.
--
Angular momentum makes the world go 'round.
From | Date | Subject | |
---|---|---|---|
Next Message | David G. Johnston | 2020-11-09 23:16:23 | Re: New "function tables" in V13 documentation |
Previous Message | David G. Johnston | 2020-11-09 21:05:48 | Re: New "function tables" in V13 documentation |