Re: Additional Chapter for Tutorial - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Additional Chapter for Tutorial
Date
Msg-id CAKFQuwaOOiSM8oYtkfsCEs-yB4ZH+8H1DgfPKhb-md7yy8Rw2g@mail.gmail.com
Whole thread Raw
In response to Re: Additional Chapter for Tutorial  (Jürgen Purtz <juergen@purtz.de>)
List pgsql-docs
On Fri, Oct 23, 2020 at 6:58 AM Jürgen Purtz <juergen@purtz.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.

pgsql-docs by date:

Previous
From: Jürgen Purtz
Date:
Subject: Re: Additional Chapter for Tutorial
Next
From: Stephen Frost
Date:
Subject: Re: Documentation: 21.5. Default Roles