Re: System catalog documentation chapter

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: System catalog documentation chapter
Дата
Msg-id YthmbgVmbk/byxDH@momjian.us
обсуждение исходный текст
Ответ на Re: System catalog documentation chapter  (Isaac Morland <isaac.morland@gmail.com>)
Ответы Re: System catalog documentation chapter  (Bruce Momjian <bruce@momjian.us>)
Список pgsql-hackers
On Wed, Jul 20, 2022 at 04:23:21PM -0400, Isaac Morland wrote:
> On Wed, 20 Jul 2022 at 16:08, Bruce Momjian <bruce@momjian.us> wrote:
> 
>     On Tue, Jul 19, 2022 at 01:41:44PM -0400, Bruce Momjian wrote:
>     > I am going to look at moving system views that make sense into the
>     > chapters where their contents are mentioned.  I don't think having a
>     > central list of views is really helping us because we expect the views
>     > to be used in ways the system catalogs would not be.
> 
>     I have grouped the views by topic.  What I would like to do next is to
>     move these view sections to the end of relevant documentation chapters.
>     Is that going to be an improvement?
> 
> 
> Will there be a comprehensive list somewhere? Even if it just lists the views,
> gives maybe a one-sentence description, and links to the relevant chapter, I
> would find that helpful sometimes.

I was not planning on that since we don't do that in any other cases I
can think of.

> I ask because I occasionally find myself wanting a comprehensive list of
> functions, and as far as I can tell it doesn't exist. I'm hoping to avoid that
> situation for views.

Well, then we just leave them where the are and link to them from other
parts of the documentation, which I assume/hope we already do.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Indecision is a decision.  Inaction is an action.  Mark Batterson




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

Предыдущее
От: Isaac Morland
Дата:
Сообщение: Re: System catalog documentation chapter
Следующее
От: Jacob Champion
Дата:
Сообщение: Re: [PATCH] Log details for client certificate failures