From: "Randall S. Becker" <rsbecker@nexbridge.com>
To: "'Felipe Contreras'" <felipe.contreras@gmail.com>,
"'Junio C Hamano'" <gitster@pobox.com>,
"'Ævar Arnfjörð Bjarmason'" <avarab@gmail.com>
Cc: <git@vger.kernel.org>, "'Derrick Stolee'" <stolee@gmail.com>,
"'Jeff King'" <peff@peff.net>,
"'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: Wed, 16 Jun 2021 17:02:45 -0400 [thread overview]
Message-ID: <011201d762f2$f82522f0$e86f68d0$@nexbridge.com> (raw)
In-Reply-To: <60ca66304a0a0_6027208c8@natae.notmuch>
>From: Felipe Contreras <felipe.contreras@gmail.com>
>Sent: June 16, 2021 4:59 PM
>To: Junio C Hamano <gitster@pobox.com>; Ævar Arnfjörð Bjarmason <avarab@gmail.com>
>Cc: git@vger.kernel.org; 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
>
>Junio C Hamano wrote:
>> Ævar Arnfjörð Bjarmason <avarab@gmail.com> writes:
>>
>> > 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.
>>
>> I actually do not mind cast of characters with concrete names,
>> especially when there are more than three parties involved and having
>> names for them help clarify the description. But I agree with you
>> that Alice and Bob should be reserved for situations where appearance
>> of Eve would reasonably be anticipated, or the use of these two names
>> become distracting to those who happen to be aware how these
>> characters are often used in CS literature.
>>
>> Perhaps s/Alice/Tabby/ and s/Bob/Fido/ or something like that ;-)?
>
>I don't know anybody named Tabby or Fido (or at least any human).
>
>Maybe Mary and John, or Linda and James.
Stevie, Jan, Pat, Chris, Randy, and Sue (if you're a Johnny Cash fan)
I have used some of those in docs.
prev parent reply other threads:[~2021-06-16 21:02 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
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 [this message]
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='011201d762f2$f82522f0$e86f68d0$@nexbridge.com' \
--to=rsbecker@nexbridge.com \
--cc=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=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.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.