Re: DOCS: Avoid using abbreviation "aka"

Laurenz Albe <laurenz.albe@cybertec.at>

From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Peter Smith <smithpb2250@gmail.com>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2024-02-29T09:14:36Z
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



Commits

  1. Doc: Improve replication slot synchronization section.

  2. Add a slot synchronization function.