From: Joshua D. Drake <jd@commandprompt.com>
To: Erik Rijkers <er@xs4all.nl>
To: Stephen Frost <sfrost@snowman.net>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: readability changes to postgres.sgml
Date: Mon, 19 Aug 2019 10:14:14 -0700
Message-ID: <2d145a56-8e09-ba0f-c76b-6a876dfa61c3@commandprompt.com> (raw)
In-Reply-To: <996bcfe233f558276f4f5962673ba164@xs4all.nl>
References: <5ac2c96d-37a6-18aa-08c4-327a6fbff24b@commandprompt.com>
<20190816002623.GS16436@tamriel.snowman.net>
<996bcfe233f558276f4f5962673ba164@xs4all.nl>
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. *****
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: jd@commandprompt.com, er@xs4all.nl, sfrost@snowman.net
Subject: Re: readability changes to postgres.sgml
In-Reply-To: <2d145a56-8e09-ba0f-c76b-6a876dfa61c3@commandprompt.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox