Re: [PATCH] Various documentation typo/grammar fixes

From: Marti Raudsepp <marti(at)juffo(dot)org>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Kevin Grittner <kgrittn(at)ymail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [PATCH] Various documentation typo/grammar fixes
Date: 2014-09-02 21:09:08
Message-ID: CABRT9RAVz97XWqpFT+tOSDkiwqJAiHvMHZxNY0hyfETFb_xn5g@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sat, Aug 30, 2014 at 8:43 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> I would argue against applying patch 2 at all.

I don't feel strongly about this, I originally didn't plan to submit
this patch at all. But I don't agree with:

> doing it only because some style guide tells
> you to is not the way to approach the issue. We're writing English
> not C code here, and so there is no single standard of correctness.

There isn't a "single standard", but there are many style guides about
English and pretty much all of them agree on the usage of periods in
"e.g.", "i.e.", "etc." and "et al."

With regards to commas following e.g. and i.e., this article surveyed
6 different English style guides and just 1 recommended not using the
comma: http://www.quickanddirtytips.com/education/grammar/ie-versus-eg?page=2

Regards,
Marti

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2014-09-02 21:30:37 Re: [PATCH] Various documentation typo/grammar fixes
Previous Message David G Johnston 2014-08-30 21:44:03 Re: [PATCH] Various documentation typo/grammar fixes