| 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: | Whole Thread | Raw Message | 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 |