Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..

From: "David E(dot) Wheeler" <david(at)justatheory(dot)com>
To: Karen Jex <karenjex(at)hotmail(dot)com>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..
Date: 2026-11-06 14:49:02
Message-ID: 0979E710-8C50-4051-87BD-6DE9ABF58938@justatheory.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Nov 6, 2026, at 09:44, Karen Jex <karenjex(at)hotmail(dot)com> wrote:

> I would love to take this on - thank you for flagging it as a potential first doc-hacking task.

Yay!

> Just to confirm my understanding:
> 1. We should use "cleartext" and "plaintext" throughout, not "clear-text", "clear text", "plain text" or "plain-text".
> 2. There is at least one case where "plaintext" is used incorrectly in place of "cleartext”.

I thought these were synonyms, in contrast to “ciphertext”. Should we not pick one to replace all of the others? Searching around a bit, it seems like “ciphertext” and “plaintext” are most often contrasting terms, e.g., https://en.wikipedia.org/wiki/Ciphertext.

Best,

David

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Karen Jex 2026-11-06 19:16:00 Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..
Previous Message Karen Jex 2026-11-06 14:44:41 Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..