Re: System catalog documentation chapter - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: System catalog documentation chapter
Date
Msg-id YthmbgVmbk/byxDH@momjian.us
Whole thread Raw
In response to Re: System catalog documentation chapter  (Isaac Morland <isaac.morland@gmail.com>)
Responses Re: System catalog documentation chapter
List 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 by date:

Previous
From: Isaac Morland
Date:
Subject: Re: System catalog documentation chapter
Next
From: Jacob Champion
Date:
Subject: Re: [PATCH] Log details for client certificate failures