Thread: Phrasing to consider (non-technical)

Phrasing to consider (non-technical)

From
PG Doc comments form
Date:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/11/static/datatype-datetime.html
Description:

On the page for Data Types - DateTime, there is this part of a sentence:

"....so the same time zone names are also recognized by much other
software."

The phrase of "much other software" is what caught me.  An optional
replacement would be: "many other software systems." or "multiple software
packages."

"much" has a connotation that doesn't fit here as well as "many" or
"multiple" would.

Thanks for the documentation.  It has been very helpful in clarifying some
things.

--Kevin.

Re: Phrasing to consider (non-technical)

From
Bruce Momjian
Date:
On Mon, Oct 29, 2018 at 02:50:22PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/11/static/datatype-datetime.html
> Description:
> 
> On the page for Data Types - DateTime, there is this part of a sentence:
> 
> "....so the same time zone names are also recognized by much other
> software."
> 
> The phrase of "much other software" is what caught me.  An optional
> replacement would be: "many other software systems." or "multiple software
> packages."
> 
> "much" has a connotation that doesn't fit here as well as "many" or
> "multiple" would.
> 
> Thanks for the documentation.  It has been very helpful in clarifying some
> things.

I just went with simpler text, patch attached and backpatched.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +

Attachment

Re: Phrasing to consider (non-technical)

From
Bruce Momjian
Date:
On Wed, Nov 21, 2018 at 04:56:40PM -0500, Bruce Momjian wrote:
> On Mon, Oct 29, 2018 at 02:50:22PM +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> > 
> > Page: https://www.postgresql.org/docs/11/static/datatype-datetime.html
> > Description:
> > 
> > On the page for Data Types - DateTime, there is this part of a sentence:
> > 
> > "....so the same time zone names are also recognized by much other
> > software."
> > 
> > The phrase of "much other software" is what caught me.  An optional
> > replacement would be: "many other software systems." or "multiple software
> > packages."
> > 
> > "much" has a connotation that doesn't fit here as well as "many" or
> > "multiple" would.
> > 
> > Thanks for the documentation.  It has been very helpful in clarifying some
> > things.
> 
> I just went with simpler text, patch attached and backpatched.

Ah, removed one too many words.  The new text is now:

         names are also recognized by other software.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +