public inbox for [email protected]  

help / color / mirror / Atom feed

From: Kevin Grittner <[email protected]>
To: Marti Raudsepp <[email protected]>
To: pgsql-docs <[email protected]>
Subject: Re: [PATCH] Various documentation typo/grammar fixes
Date: Mon, 25 Aug 2014 06:46:47 -0700
Message-ID: <[email protected]> (raw)
In-Reply-To: <CABRT9RA_kHEZrw9W=C_yYpR8+TTLqVMVKUSU0hrLC213cJ4Hyg@mail.gmail.com>
References: <CABRT9RA_kHEZrw9W=C_yYpR8+TTLqVMVKUSU0hrLC213cJ4Hyg@mail.gmail.com>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

Marti Raudsepp <[email protected]> wrote:

> I ran the Topy typo-fixer (https://github.com/intgr/topy , using rules
> developed for Wikipedia) over the PostgreSQL documentation directory.
> Attached is a patch with hand-picked fixes that are clearly an
> improvement.
>
> There are also some changes that I didn't include that seem somewhat
> opinionated, for example:
> * "eg" -> "e.g."
> * "etc" -> "etc."

These two seem to me like they should be changed; otherwise they 
just don't look correct.

> * "the exact same" -> "exactly the same"

The old version sounds a bit colloquial to my ear, so it seems like 
it may be worth changing.  The problem is, this change doesn't seem 
like it would generally be a direct substitution; it may require a 
major reorganization of the sentence.  I think the resulting 
sentences need to be compared to see which is more clear and 
concise.

> * "newly-received" -> "newly received"
> * "recently-used" -> "recently used"

I think these depend on context.  To me, the former scans better 
when the combination of words is used as an adjective.

--
Kevin Grittner
EDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company


-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

view thread (14+ messages)  latest in thread

reply

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: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: [PATCH] Various documentation typo/grammar fixes
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox