Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1hzwom-0006Hi-GP
	for pgsql-docs@arkaria.postgresql.org; Tue, 20 Aug 2019 05:36:28 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1hzwok-0003wI-Tx
	for pgsql-docs@arkaria.postgresql.org; Tue, 20 Aug 2019 05:36:26 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <er@xs4all.nl>)
	id 1hzwok-0003wB-JN
	for pgsql-docs@lists.postgresql.org; Tue, 20 Aug 2019 05:36:26 +0000
Received: from lb1-smtp-cloud9.xs4all.net ([194.109.24.22])
	by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.92)
	(envelope-from <er@xs4all.nl>)
	id 1hzwod-0001dC-Py
	for pgsql-docs@postgresql.org; Tue, 20 Aug 2019 05:36:25 +0000
Received: from webmailclassic.xs4all.nl ([IPv6:2001:888:0:22:194:109:20:215])
	by smtp-cloud9.xs4all.net with ESMTPA
	id zwoZhL5R9zaKOzwoZhtBal; Tue, 20 Aug 2019 07:36:16 +0200
Received: from 2001:983:39b6:1:6193:8ef9:e977:5dc4
 by webmailclassic.xs4all.nl
 with HTTP (HTTP/1.1 POST); Tue, 20 Aug 2019 07:36:15 +0200
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII;
 format=flowed
Content-Transfer-Encoding: 7bit
Date: Tue, 20 Aug 2019 07:36:15 +0200
From: Erik Rijkers <er@xs4all.nl>
To: Michael Paquier <michael@paquier.xyz>
Cc: "Joshua D. Drake" <jd@commandprompt.com>, Stephen Frost
 <sfrost@snowman.net>, pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: readability changes to postgres.sgml
In-Reply-To: <20190820050530.GC1841@paquier.xyz>
References: <5ac2c96d-37a6-18aa-08c4-327a6fbff24b@commandprompt.com>
 <20190816002623.GS16436@tamriel.snowman.net>
 <996bcfe233f558276f4f5962673ba164@xs4all.nl>
 <bf0b706b7c4ab0f3f298b5d1c09f0b2c@xs4all.nl>
 <317b2dec-264b-2085-fc9c-10f2feca3693@commandprompt.com>
 <20190820050530.GC1841@paquier.xyz>
Message-ID: <0b91a025a27aaade21809b7b7b72356a@xs4all.nl>
X-Sender: er@xs4all.nl
User-Agent: XS4ALL Webmail
X-CMAE-Envelope: 
 MS4wfO8zbjQPfUDvP7rg4lbHJZ//+m+YA08g9shDbyIWYqMb8vT0Z2WrArPPwTUMijqOjI//SWUNTVFJJfGvRqK7g6LRBkQa71O5quggeFUygdYQXltkG1F5
 ovf+woQDOrJj9PLJ98qU160ARRkNtTjxLpBwXypsDvLKuXrkKUSUhM9FXAi6o0ZlSCt4pEc0Uyl1qKDzDzqiMmlP34aqaKqYhdhYmFeGn0DMSeiydFF/ouIq
 seQzOB3ieuqgVnuzru5UekcXcCT/YTpAXq96dElqU7UdDByckUfMEdPYsTbqWo9w7RGPslxA86aHOkzIGYcH9Q==
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk

On 2019-08-20 07:05, Michael Paquier wrote:
> On Mon, Aug 19, 2019 at 04:00:13PM -0700, Joshua D. Drake wrote:
>> New version attached with spelling errors fixed.
> 
> I have gone through this patch, and I have a hard time understanding
> why these are improvements over the existing wording.  In what does
> this make things better?

It's pretty simple, it improves readability.  It does so mainly by 
removing unnecessary text.

+1