Skip site navigation (1) Skip section navigation (2)

Re: PostgreSQL vs. Postgres labeling inconsistency

From: David Fetter <david(at)fetter(dot)org>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: PostgreSQL vs. Postgres labeling inconsistency
Date: 2007-10-05 18:26:50
Message-ID: 20071005182650.GD6005@fetter.org (view raw or flat)
Thread:
Lists: pgsql-docs
On Fri, Oct 05, 2007 at 07:22:01PM +0200, Peter Eisentraut wrote:
> Some of you may have noticed that there was a move proposed to use
> "Postgres" alongside "PostgreSQL" as a product name in the
> documentation and other written resources.  A change along that line
> has already been made in the FAQ.
> 
> Many points have been made recently on the name of the project or
> the product, but the fact is that it will always be one or the other
> at any particular time.  It's fine to have alternative names.  But
> keep in mind that the purpose of documentation is to convey
> information, not to make subtle points about naming issues.  If you
> want to make points about naming issues, write a nonsubtle document
> about it.

+1

> Others have also made points that it is OK to use acronyms in place
> of the full name, and "Postgres" could be that, or that it's like
> Coke vs Coca-Cola.
> 
> Nevertheless, any writing resource or technical editor will tell you
> that you need to be consistent.  If you want to use an acronym, you
> introduce it once, and then you use it all the time.  And if you
> write an article about beverages, you will use either Coke or
> Coca-Cola throughout, not both.  If the terminology or the acronyms
> are not clear, you explain it at the beginning, and readers will
> look it up there.
> 
> I believe both the FAQ and the documentation do explain the naming
> issue near the beginning.  But the rest of the document should use
> one name consistently, or it will just look silly and confusing.
> Also consider that many of our written resources are not read
> linearly, so it becomes even more important to use consistent
> terminology that does not require much context to understand.
> 
> So I think what is being proposed is wrong and needs to be reverted.

That, or (my preference) make the change larger.  I think it's
significant that the vast majority of compatible software has some
variant of Postgres and *not* PostgreSQL in the name.

Cheers,
David.
-- 
David Fetter <david(at)fetter(dot)org> http://fetter.org/
phone: +1 415 235 3778        AIM: dfetter666
                              Skype: davidfetter

Remember to vote!
Consider donating to PostgreSQL: http://www.postgresql.org/about/donate

In response to

Responses

pgsql-docs by date

Next:From: Joshua D. DrakeDate: 2007-10-05 18:43:45
Subject: Re: PostgreSQL vs. Postgres labeling inconsistency
Previous:From: Joshua D. DrakeDate: 2007-10-05 17:30:12
Subject: Re: PostgreSQL vs. Postgres labeling inconsistency

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group