Subject: Re: Additional Chapter for Tutorial
To: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>,
 pgsql-docs@lists.postgresql.org
References: <13c65997-9502-7671-1a7b-50e5d5093514@purtz.de>
 <40aca6b45b0da614b94c8ef86d89b70b@xs4all.nl>
 <4b8bdb3b-10a7-e541-18ff-6a556ce89cd1@purtz.de>
 <9df5b9c8-71fe-47a8-4670-346a0ae7e2cd@purtz.de>
 <d2a0cb79-7c87-9bb2-2bb9-9465ba69d854@2ndquadrant.com>
 <f3eeae6c-7e4d-4185-d792-9c97b9fd65f1@purtz.de>
 <567f7c92-dce9-7424-9022-54b31eb12740@purtz.de>
 <1B5F7D1E-B389-4D3B-973A-A8D183D8530A@yesql.se>
 <fdd0fd52-84d3-f7a1-b8c7-aed108d95615@purtz.de>
 <766cab17c6af48956558611520956b77@xs4all.nl>
 <ddfd3e05-407c-5e7b-d9f1-fadee15b5348@purtz.de>
 <d8e2f31f-f2e8-0482-2b10-2ae06a6b8fb7@2ndquadrant.com>
 <93fd8e15-8639-23c8-c7c4-d4cfca323189@purtz.de>
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <c02449fa-5873-bddf-348e-cf174faa77e0@2ndquadrant.com>
Date: Thu, 10 Sep 2020 18:26:59 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:52.0)
 Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <93fd8e15-8639-23c8-c7c4-d4cfca323189@purtz.de>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Precedence: bulk

On 2020-09-02 09:04, Jürgen Purtz wrote:
> On 01.09.20 23:30, Peter Eisentraut wrote:
>> It is mostly advanced low-level information that is irrelevant for
>> someone starting up,
> That applies only to the VACUUM chapter. VACUUM and AUTOVACUUM are
> controlled by a lot of parameters. Therefor the current documentation
> concerning the two mechanism spreads the description across different
> pages (20.4, 25.1, VACUUM command). Because of the structure of our
> documentation that's ok. But we should have a summary page somewhere -
> not necessarily in the tutorial.

There is probably room for improvement, but the section numbers you 
mention are not about VACUUM, AFAICT, so I can't really comment on what 
you have in mind.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services