Subject: Re: readability changes to postgres.sgml
To: Erik Rijkers <er@xs4all.nl>, Stephen Frost <sfrost@snowman.net>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
References: <5ac2c96d-37a6-18aa-08c4-327a6fbff24b@commandprompt.com>
 <20190816002623.GS16436@tamriel.snowman.net>
 <996bcfe233f558276f4f5962673ba164@xs4all.nl>
From: "Joshua D. Drake" <jd@commandprompt.com>
Organization: Command Prompt, Inc.
Message-ID: <2d145a56-8e09-ba0f-c76b-6a876dfa61c3@commandprompt.com>
Date: Mon, 19 Aug 2019 10:14:14 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101
 Thunderbird/60.8.0
MIME-Version: 1.0
In-Reply-To: <996bcfe233f558276f4f5962673ba164@xs4all.nl>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Precedence: bulk

On 8/15/19 10:22 PM, Erik Rijkers wrote:
> On 2019-08-16 02:26, Stephen Frost wrote:
>> Greetings,
>>
>> * Joshua D. Drake (jd@commandprompt.com) wrote:
>>> attached
>
>> they seem to be simply removing words and removing content that is
>
> For what it's worth, I think the proposed changes are all solid 
> improvements. The text reads better with them, and that's what this is 
> about -- not whether the removed little text-pieces were 'true' or not.

Correct, the point of these patches is to make the documentation 
succinct and hopefully more clear. Any writing class you take will tell 
you that the less words you can use to make the point, the better. 
Further, language interpretation changes over time and certain 
adjectives will not have the impact they once did. As I have been 
reviewing the docs, the language used although correct is often clumsy.

>
> However, there is one typo:
>
> +    read independently.  There are many extrernal programming
>
> extrernal -> external
> (and I would say that dropping that word 'external' would be another 
> little improvement)
>

Good catch, should I submit a new patch or will it be fixed if applied?


JD


-- 
Command Prompt, Inc. || http://the.postgres.company/ || @cmdpromptinc
Postgres centered full stack support, consulting and development.
Advocate: @amplifypostgres || Get help: https://commandprompt.com/
*****     Unless otherwise stated, opinions are my own.   *****