To: "Robert Treat" <xzilla@users.sourceforge.net>
Cc: <pgsql-advocacy@postgresql.org>,  "Bruce Momjian" <bruce@momjian.us>
Subject: Re: Pattern for use of the alias "Postgres"
In-Reply-To: <200710251210.02905.xzilla@users.sourceforge.net> (Robert Treat's
	message of "Thu\, 25 Oct 2007 12\:10\:02 -0400")
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1 (gnu/linux)
References: <200710251532.l9PFWTW09836@momjian.us>
	<200710251210.02905.xzilla@users.sourceforge.net>
From: Gregory Stark <stark@enterprisedb.com>
Organization: EnterpriseDB
Date: Thu, 25 Oct 2007 19:14:40 +0100
Message-ID: <87r6jj83jj.fsf@oxford.xeocode.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

"Robert Treat" <xzilla@users.sourceforge.net> writes:

> On Thursday 25 October 2007 11:32, Bruce Momjian wrote:
>
>> So, for the FAQ, which currently uses the second-entry-per-paragraph
>> logic, should it be changed to the logic suggested above where every
>> mention but the first is "Postgres"?  (This will of course affect the
>> documentation changes when we are ready to discuss those.)
>
> IMHO (and others as well, since this has been raised by others as well) this 
> only makes are docs / faqs / etc... more confusing, and I think the use of 
> both names scattered through is more confusing.  We should strive to be 
> consistent with our useage, whichever name we want to use. 

IMHO the FAQ is an informal document like email or wiki pages. It should use
whatever the maintainer feels most comfortable with (and use it consistently).
There should be an FAQ entry explaining the relationship. Effectively a
second-entry-per-document rule, not second-entry-per-paragraph.

The manual and reference are part of the source base and should consistently
use the same name as the rest of the source.

-- 
  Gregory Stark
  EnterpriseDB          http://www.enterprisedb.com