Re: readability changes to postgres.sgml

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

In response to

Browse pgsql-docs by date

  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