Re: System catalog documentation chapter

On Wed, Jul 20, 2022 at 04:23:21PM -0400, Isaac Morland wrote:
> On Wed, 20 Jul 2022 at 16:08, Bruce Momjian <bruce(at)momjian(dot)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(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

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