git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: "Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
To: "Robert P. J. Day" <rpjday@crashcourse.ca>
Cc: git@vger.kernel.org, Junio C Hamano <gitster@pobox.com>,
	Derrick Stolee <stolee@gmail.com>, Jeff King <peff@peff.net>,
	Felipe Contreras <felipe.contreras@gmail.com>,
	Bagas Sanjaya <bagasdotme@gmail.com>,
	Robert Karszniewicz <avoidr@posteo.de>,
	Emily Shaffer <emilyshaffer@google.com>
Subject: Re: [PATCH 0/6] doc: replace "alice" and "bob" examples
Date: Tue, 15 Jun 2021 20:45:33 +0200	[thread overview]
Message-ID: <874kdzymzh.fsf@evledraar.gmail.com> (raw)
In-Reply-To: <18b53cae-6da9-c970-b994-caee11c5baf9@crashcourse.ca>


On Tue, Jun 15 2021, Robert P. J. Day wrote:

> On Tue, 15 Jun 2021, Ævar Arnfjörð Bjarmason wrote:
>
>> I suggested in [1] that the "alice" and "bob" examples in our
>> documentation would be better written without a reference to such
>> fictional characters, for reasons that have nothing to do with trying
>> to bend over backwards to avoid any reference to people's gender. It
>> just makes for better documentation.
>
>   no, it doesn't ... and wikipedia explains it nicely:

It doesn't make for better documentation? Maybe not, but can you comment
on specific parts of the changes in this series that make it worse?

> https://en.wikipedia.org/wiki/Alice_and_Bob
>
> "In cryptography, Alice and Bob are fictional characters commonly used
> as placeholders in discussions about cryptographic protocols or
> systems, and in other science and engineering literature where there
> are several participants in a thought experiment. The Alice and Bob
> characters were invented by Ron Rivest, Adi Shamir, and Leonard
> Adleman in their 1978 paper "A Method for Obtaining Digital Signatures
> and Public-key Cryptosystems".[1] Subsequently, they have become
> common archetypes in many scientific and engineering fields, such as
> quantum cryptography, game theory and physics.[2] As the use of Alice
> and Bob became more widespread, additional characters were added,
> sometimes each with a particular meaning. These characters do not have
> to refer to humans; they refer to generic agents which might be
> different computers or even different programs running on a single
> computer."
>
>   if you want to make the docs better, have at it, but please don't do
> something as meaningless as replacing "bob" and "alice" because you're
> feeling politically correct, or woke, or whatever the hell the kids
> call it these days.
>
>   jesus ...

I believe that the commit message of 1/6 addresses the point you're
raising here:
http://lore.kernel.org/git/patch-1.6-abbb5b9ba13-20210615T161330Z-avarab@gmail.com

  reply	other threads:[~2021-06-15 18:57 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-15 16:17 [PATCH 0/6] doc: replace "alice" and "bob" examples Ævar Arnfjörð Bjarmason
2021-06-15 16:17 ` [PATCH 1/6] gittutorial doc: replace "alice" and "bob" with "you" and "www-data" Ævar Arnfjörð Bjarmason
2021-06-16  3:43   ` Bagas Sanjaya
2021-06-16  4:50     ` Junio C Hamano
2021-06-16 21:04     ` Felipe Contreras
2021-06-17 20:38     ` Ævar Arnfjörð Bjarmason
2021-06-15 16:17 ` [PATCH 2/6] gitcvs-migration " Ævar Arnfjörð Bjarmason
2021-06-16  4:02   ` Bagas Sanjaya
2021-06-15 16:18 ` [PATCH 3/6] daemon doc + code comments: reword "alice" example Ævar Arnfjörð Bjarmason
2021-06-15 16:18 ` [PATCH 4/6] fast-import doc: change "bob" in an example to "file.txt" Ævar Arnfjörð Bjarmason
2021-06-15 16:18 ` [PATCH 5/6] doc: replace "alice" and "bob" with "jdoe" and "msmith" Ævar Arnfjörð Bjarmason
2021-06-15 16:18 ` [PATCH 6/6] pack-protocol doc: use "www-data" in place of "alice" Ævar Arnfjörð Bjarmason
2021-06-15 16:46 ` [PATCH 0/6] doc: replace "alice" and "bob" examples Robert P. J. Day
2021-06-15 18:45   ` Ævar Arnfjörð Bjarmason [this message]
2021-06-15 16:54 ` Felipe Contreras
2021-06-15 19:09   ` Ævar Arnfjörð Bjarmason
2021-06-16 20:56     ` Felipe Contreras
2021-06-17 15:48       ` Phillip Susi
2021-06-17 20:51         ` Ævar Arnfjörð Bjarmason
2021-06-16  1:52 ` Junio C Hamano
2021-06-16  9:30   ` Robert P. J. Day
2021-06-16 12:00     ` Jeff King
2021-06-16 20:59   ` Felipe Contreras
2021-06-16 21:02     ` Randall S. Becker

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=874kdzymzh.fsf@evledraar.gmail.com \
    --to=avarab@gmail.com \
    --cc=avoidr@posteo.de \
    --cc=bagasdotme@gmail.com \
    --cc=emilyshaffer@google.com \
    --cc=felipe.contreras@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=peff@peff.net \
    --cc=rpjday@crashcourse.ca \
    --cc=stolee@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).