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

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

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
Jun 15, 2021, 16:17 UTC
Message-ID
<cover-0.6-00000000000-20210615T161330Z-avarab@gmail.com>

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.

Since it's clear that Derrick's not interested in picking up that task in his parallel series[2] here a brief series to implement that. This leaves the only occurances of "alice" and "bob" (and "david" and "cindy") at the bottom of giteveryday(7). Those could also be changed, but I didn't think doing so provided a clear benefit, unlike the changes being made here.

1. https://lore.kernel.org/git/875yyp4fun.fsf@evledraar.gmail.com/
2. pull.975.v3.git.1623766273.gitgitgadget@gmail.com
Ævar Arnfjörð Bjarmason (6):
  gittutorial doc: replace "alice" and "bob" with "you" and "www-data"
  gitcvs-migration doc: replace "alice" and "bob" with "you" and
    "www-data"
  daemon doc + code comments: reword "alice" example
  fast-import doc: change "bob" in an example to "file.txt"
  doc: replace "alice" and "bob" with "jdoe" and "msmith"
  pack-protocol doc: use "www-data" in place of "alice"
 Documentation/git-credential.txt          |   2 +-
 Documentation/git-daemon.txt              |  13 ++-
 Documentation/git-fast-import.txt         |  14 ++-
 Documentation/git-imap-send.txt           |   4 +-
 Documentation/git-interpret-trailers.txt  |  22 ++--
 Documentation/gitcvs-migration.txt        |  18 +--
 Documentation/gittutorial.txt             | 128 +++++++++++-----------
 Documentation/technical/pack-protocol.txt |   4 +-
 daemon.c                                  |  10 +-
 9 files changed, 112 insertions(+), 103 deletions(-)
-- 
2.32.0.555.g0268d380f7b
Next: Ævar Arnfjörð Bjarmason
Message 1 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.