Re: DOCS: Avoid using abbreviation "aka" - Mailing list pgsql-hackers

From Laurenz Albe
Subject Re: DOCS: Avoid using abbreviation "aka"
Date
Msg-id 297fa70b2b94cdc8319c7976d99d9eb6467bf51b.camel@cybertec.at
Whole thread Raw
In response to DOCS: Avoid using abbreviation "aka"  (Peter Smith <smithpb2250@gmail.com>)
List 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



pgsql-hackers by date:

Previous
From: Amit Kapila
Date:
Subject: Re: DOCS: Avoid using abbreviation "aka"
Next
From: Michael Banck
Date:
Subject: Re: Remove AIX Support (was: Re: Relation bulk write facility)