Subject: Re: readability changes to postgres.sgml
To: Liudmila Mantrova <l.mantrova@gmail.com>, 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>
 <CAEkD-mC4uq9a_yO+OSdkJVG2FZHh2KrqQSXkSxFaTQHD+fRFLw@mail.gmail.com>
From: "Joshua D. Drake" <jd@commandprompt.com>
Organization: Command Prompt, Inc.
Message-ID: <a349bf97-4e1c-424e-7cb8-2f258b26dda5@commandprompt.com>
Date: Mon, 19 Aug 2019 10:15:36 -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: 
 <CAEkD-mC4uq9a_yO+OSdkJVG2FZHh2KrqQSXkSxFaTQHD+fRFLw@mail.gmail.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Precedence: bulk

On 8/16/19 10:41 AM, Liudmila Mantrova wrote:
>
>
>     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.
>
> If we want to make these intros more concise, one of the easiest ways 
> to achieve this is to address the reader directly ("Readers looking 
> for xxx are encouraged to look" vs. smth like "For xxx, see").

This is true and my counter argument is that a call to action is more 
likely to get the reader to do something.

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.   *****