Re: New "function tables" in V13 documentation

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.

In response to

Responses

Browse pgsql-general by date

  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