From: Gregory Stark <stark@enterprisedb.com>
To: Robert Treat <xzilla@users.sourceforge.net>
Cc: pgsql-advocacy@postgresql.org
Cc: Bruce Momjian <bruce@momjian.us>
Subject: Re: Pattern for use of the alias "Postgres"
Date: Thu, 25 Oct 2007 19:14:40 +0100
Message-ID: <87r6jj83jj.fsf@oxford.xeocode.com> (raw)
In-Reply-To: <200710251210.02905.xzilla@users.sourceforge.net>
References: <200710251532.l9PFWTW09836@momjian.us>
<200710251210.02905.xzilla@users.sourceforge.net>
"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
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: pgsql-docs@postgresql.org
Cc: stark@enterprisedb.com, xzilla@users.sourceforge.net, pgsql-advocacy@postgresql.org, bruce@momjian.us
Subject: Re: Pattern for use of the alias "Postgres"
In-Reply-To: <87r6jj83jj.fsf@oxford.xeocode.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox