From: Joshua D. Drake <jd@commandprompt.com>
To: Liudmila Mantrova <l.mantrova@gmail.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:15:36 -0700
Message-ID: <a349bf97-4e1c-424e-7cb8-2f258b26dda5@commandprompt.com> (raw)
In-Reply-To: <CAEkD-mC4uq9a_yO+OSdkJVG2FZHh2KrqQSXkSxFaTQHD+fRFLw@mail.gmail.com>
References: <5ac2c96d-37a6-18aa-08c4-327a6fbff24b@commandprompt.com>
<20190816002623.GS16436@tamriel.snowman.net>
<996bcfe233f558276f4f5962673ba164@xs4all.nl>
<CAEkD-mC4uq9a_yO+OSdkJVG2FZHh2KrqQSXkSxFaTQHD+fRFLw@mail.gmail.com>
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. *****
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, l.mantrova@gmail.com, er@xs4all.nl, sfrost@snowman.net
Subject: Re: readability changes to postgres.sgml
In-Reply-To: <a349bf97-4e1c-424e-7cb8-2f258b26dda5@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