From: | "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com> |
---|---|
To: | Liudmila Mantrova <l(dot)mantrova(at)gmail(dot)com>, Erik Rijkers <er(at)xs4all(dot)nl>, Stephen Frost <sfrost(at)snowman(dot)net> |
Cc: | pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: readability changes to postgres.sgml |
Date: | 2019-08-19 17:15:36 |
Message-ID: | a349bf97-4e1c-424e-7cb8-2f258b26dda5@commandprompt.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
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. *****
From | Date | Subject | |
---|---|---|---|
Next Message | Joshua D. Drake | 2019-08-19 19:16:53 | Re: readability changes to postgres.sgml |
Previous Message | Joshua D. Drake | 2019-08-19 17:14:14 | Re: readability changes to postgres.sgml |