References: 
 <CABRT9RA_kHEZrw9W=C_yYpR8+TTLqVMVKUSU0hrLC213cJ4Hyg@mail.gmail.com> 
Message-ID: <1408994031.21717.YahooMailNeo@web122306.mail.ne1.yahoo.com>
Date: Mon, 25 Aug 2014 12:13:51 -0700
From: Kevin Grittner <kgrittn@ymail.com>
Reply-To: Kevin Grittner <kgrittn@ymail.com>
Subject: Re: [PATCH] Various documentation typo/grammar fixes
To: Marti Raudsepp <marti@juffo.org>, pgsql-docs <pgsql-docs@postgresql.org>
In-Reply-To: 
 <CABRT9RA_kHEZrw9W=C_yYpR8+TTLqVMVKUSU0hrLC213cJ4Hyg@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

Marti Raudsepp <marti@juffo.org> 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.

For the initial patch, I agree with all except the first change of
"others'" to "other's" -- the start of the sentence uses "All", so
there is clearly more than one "other", so the the apostrophe
belongs after the "s".=A0 The rest of the 0001- patch all look like
improvements to me.

I think most or all of the places that the 0002- patch (i.e. and
e.g.) need a change to look right, but I'm not sure this goes far
enough.=A0 In style guides I've had to use these generally should
follow punctuation (left parenthesis, colon, semi-colon, comma, or
em dash), and be separated from any following text by punctuation
-- usually a comma.

In patch 0003- I agree that the change to "exactly the same" reads
better.=A0 I'm torn on changing the hyphens to spaces.=A0 I probably
wouldn't change them, but I wouldn't squawk if others preferred to
do so.

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


--=20
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs