Re: DOCS: Avoid using abbreviation "aka"

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: Peter Smith <smithpb2250(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: DOCS: Avoid using abbreviation "aka"
Date: 2024-02-29 09:14:36
Message-ID: 297fa70b2b94cdc8319c7976d99d9eb6467bf51b.camel@cybertec.at
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, 2024-02-29 at 16:51 +1100, Peter Smith wrote:
> While checking some recently pushed changes [1] I noticed
> documentation [2] that includes the abbreviation "aka".
>
> IMO it is preferable to avoid informal abbreviations like "aka" in the
> documents, because not everyone will understand the meaning.
> Furthermore, I think this is reinforced by the fact this was the
> *only* example of "aka" that I could find in all of the .sgml. Indeed,
> assuming that "aka" is short for "also known as" then the sentence
> still doesn't seem correct even after those words are substituted.

+1

Yours,
Laurenz Albe

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Banck 2024-02-29 09:24:24 Re: Remove AIX Support (was: Re: Relation bulk write facility)
Previous Message Amit Kapila 2024-02-29 09:12:08 Re: DOCS: Avoid using abbreviation "aka"