Re: New "function tables" in V13 documentation

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: New "function tables" in V13 documentation
Дата
Msg-id CAKFQuwaSjzEaC_Dbs7tqvnGT6hvOuAsmmfGf2jkpF4niTECA9g@mail.gmail.com
обсуждение исходный текст
Ответ на Re: New "function tables" in V13 documentation  (Ron <ronljohnsonjr@gmail.com>)
Список pgsql-general
On Mon, Nov 9, 2020 at 3:30 PM Ron <ronljohnsonjr@gmail.com> wrote:
On 11/9/20 3:05 PM, David G. Johnston wrote:
On Mon, Nov 9, 2020 at 2:01 PM Ron <ronljohnsonjr@gmail.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.


Because agreement without elaboration usually just merits a +1 so I read more into the statement than you intended.

David J.

В списке pgsql-general по дате отправления:

Предыдущее
От: Ron
Дата:
Сообщение: Re: New "function tables" in V13 documentation
Следующее
От: Michael Lewis
Дата:
Сообщение: Re: Execution plan does not use index