pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Robert Treat <xzilla@users.sourceforge.net>
To: pgsql-advocacy@postgresql.org
Cc: Bruce Momjian <bruce@momjian.us>
Subject: Re: Pattern for use of the alias "Postgres"
Date: Thu, 25 Oct 2007 12:10:02 -0400
Message-ID: <200710251210.02905.xzilla@users.sourceforge.net> (raw)
In-Reply-To: <200710251532.l9PFWTW09836@momjian.us>
References: <200710251532.l9PFWTW09836@momjian.us>

On Thursday 25 October 2007 11:32, Bruce Momjian wrote:
> [ BCC to docs because this might affect documentation too.]
>
> You probably remember the discussion about promoting the use of the
> alias "Postgres" in addition to the official name "PostgreSQL".  I have
> changed the FAQ so that in paragraphs with multiple references to
> "PostgreSQL" we also use the alias "Postgres".
>
> I have talked about a similar change to our documentation and perhaps
> the web site, but I am _not_ ready to discuss those.
>
> What I want to ask about is an idea a few people have mentioned.  They
> don't like that we change usage in the same paragraph.  The suggestion
> is to mention that "Postgres" is an alias to "PostgreSQL" at the top of
> the document and just use "Postgres" in the remainder of the document.
>
> This seems like a lot more use of the alias than I though we wanted as a
> group, but because several of the people suggesting this also didn't
> want the alias at all, I figure I should ask and we can discuss it.
>
> 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. 

-- 
Robert Treat
Build A Brighter LAMP :: Linux Apache {middleware} Postgre



view thread (24+ messages)  latest in thread

Message-ID: <200710251210.02905.xzilla@users.sourceforge.net>
Permalink:  ../200710251210.02905.xzilla@users.sourceforge.net/
Also on:    postgresql.org/message-id/200710251210.02905.xzilla@users.sourceforge.net

 · 

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: pgsql-docs@postgresql.org
  Cc: xzilla@users.sourceforge.net, pgsql-advocacy@postgresql.org, bruce@momjian.us
  Subject: Re: Pattern for use of the alias "Postgres"
  In-Reply-To: <200710251210.02905.xzilla@users.sourceforge.net>

* 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