git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 0/6] doc: replace "alice" and "bob" examples

From
Jeff King <peff@peff.net>
Date
Jun 16, 2021, 12:00 UTC
Message-ID
<YMnn64zrMO1T1HTY@coredump.intra.peff.net>
In-Reply-To
<9217211e-aa26-c1c9-2528-a29b93ff174e@crashcourse.ca>
On Wed, Jun 16, 2021 at 05:30:14AM -0400, Robert P. J. Day wrote:
Show 26 quoted lines
> On Wed, 16 Jun 2021, 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 look forward to the renaming of "git" to something more innocuous
> and palatable because, somewhere, someone could conceivably,
> hypothetically, theoretically take exception to it.
> 
>   seriously, can we start a second mailing list where people want to
> talk about, you know, version control?
Can you please tone down your responses a bit?

One of the points under discussion here is whether those names end up being confusing to users because of their use in other places (like cryptographic examples). And I think the comprehensibility of our documentation is quite relevant to the project.

But even if this were done purely for reasons of gender-neutrality, I still think your response is inappropriate. You are quite welcome to argue against such a change, but snarky or dismissive responses aren't welcome.

(I'm referring to the last paragraph of your other response in this thread, too. I did find the wikipedia link you sent earlier helpful to the discussion, and personally I don't find the names confusing at all, for the reasons it mentioned. But that may not be universal).

-Peff
Previous: Robert P. J. DayNext: Felipe Contreras
Message 22 of 24 in “doc: replace "alice" and "bob" examples”
  1. 0/6 doc: replace "alice" and "bob" examplesÆvar Arnfjörð Bjarmason, Jun 15, 2021
  2. 1/6 gittutorial doc: replace "alice" and "bob" with "you" and "www-data"Ævar Arnfjörð Bjarmason, Jun 15, 2021
  3. Bagas SanjayaJun 16, 2021
  4. Junio C HamanoJun 16, 2021
  5. Felipe ContrerasJun 16, 2021
  6. Ævar Arnfjörð BjarmasonJun 17, 2021
  7. 2/6 gitcvs-migration doc: replace "alice" and "bob" with "you" and "www-data"Ævar Arnfjörð Bjarmason, Jun 15, 2021
  8. Bagas SanjayaJun 16, 2021
  9. 3/6 daemon doc + code comments: reword "alice" exampleÆvar Arnfjörð Bjarmason, Jun 15, 2021
  10. 4/6 fast-import doc: change "bob" in an example to "file.txt"Ævar Arnfjörð Bjarmason, Jun 15, 2021
  11. 5/6 doc: replace "alice" and "bob" with "jdoe" and "msmith"Ævar Arnfjörð Bjarmason, Jun 15, 2021
  12. 6/6 pack-protocol doc: use "www-data" in place of "alice"Ævar Arnfjörð Bjarmason, Jun 15, 2021
  13. Robert P. J. DayJun 15, 2021
  14. Ævar Arnfjörð BjarmasonJun 15, 2021
  15. Felipe ContrerasJun 15, 2021
  16. Ævar Arnfjörð BjarmasonJun 15, 2021
  17. Felipe ContrerasJun 16, 2021
  18. Phillip SusiJun 17, 2021
  19. Ævar Arnfjörð BjarmasonJun 17, 2021
  20. Junio C HamanoJun 16, 2021
  21. Robert P. J. DayJun 16, 2021
  22. Jeff KingJun 16, 2021
  23. Felipe ContrerasJun 16, 2021
  24. Randall S. BeckerJun 16, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.