Re: Additional Chapter for Tutorial

Jürgen Purtz <juergen@purtz.de>

From: Jürgen Purtz <juergen@purtz.de>
To: pgsql-docs@lists.postgresql.org
Date: 2020-09-02T07:04:38Z
Lists: pgsql-hackers, pgsql-docs
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.

> the most part the information just duplicates what is already 
> explained elsewhere.

That is the nature of a tutorial respectively a summary.

--

J. Purtz





Commits

  1. Align some terms in arch-dev.sgml to glossary

  2. doc: Copy-edit the "Overview of PostgreSQL Internals" chapter

  3. Merge postmaster and postgres command into just postgres. postmaster