Re: Additional Chapter for Tutorial

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Additional Chapter for Tutorial
Date: 2020-10-23 16:15:14
Message-ID: CAKFQuwaOOiSM8oYtkfsCEs-yB4ZH+8H1DgfPKhb-md7yy8Rw2g@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Fri, Oct 23, 2020 at 6:58 AM Jürgen Purtz <juergen(at)purtz(dot)de> wrote:

> Creating such a chapter in "VII. Internals" will increase the existing
> chapter numbers 50 - 71, which may lead to some confusion. On the other
> hand the content can possibly be applied to all supported PG versions at
> the same time, which will lead to a consistent behavior. Extending one of
> the existing chapters won't work because all of them handle their own
> topic, eg.: "50. Overview of PostgreSQL Internals" (misleading title?)
> focuses on the handling of SQL statements from parsing to execution.
>
> What are your thoughts?
>
v14 has already added a new chapter, installation from binaries. It was
not back-patched. To my knowledge no one brought up these points - numbers
changing or back-patching the new material. I don't see that this
enhancement needs to be treated any differently.

David J.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Stephen Frost 2020-10-23 21:40:37 Re: Documentation: 21.5. Default Roles
Previous Message Jürgen Purtz 2020-10-23 13:58:46 Re: Additional Chapter for Tutorial

Browse pgsql-hackers by date

  From Date Subject
Next Message Jehan-Guillaume de Rorthais 2020-10-23 16:31:53 Re: The ultimate extension hook.
Previous Message David G. Johnston 2020-10-23 16:08:50 Re: [PATCH] Add section headings to index types doc