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

Re: [PATCH] Document patch syntax.

From
Karl Hasselström <kha@treskal.com>
Date
May 12, 2007, 18:32 UTC
Message-ID
<20070512183255.GD28039@diana.vm.bytemark.co.uk>
In-Reply-To
<20070512143827.GE16903@nan92-1-81-57-214-146.fbx.proxad.net>
On 2007-05-12 16:38:27 +0200, Yann Dirson wrote:
Show 6 quoted lines
> However, that makes me think we should probably use guideline for
> the docs - here comes the question of which convention to use when
> refering to the user. Do we address her directly ("you"), indirectly
> ("the user", "her" - don't remember where the "female user" use
> comes from, but we could maybe follow this), even more indirectly
> ("one"), or any other way ?

I'd go with "you", or possibly "one" (but I strongly prefer "you"). Talking about the user in the third person ("the user", "her", etc.) seems actively wrong when we are instructing the user on how to do things.

-- 
Karl Hasselström, kha@treskal.com
      www.treskal.com/kalle
Previous: Yann DirsonNext: Junio C Hamano
Message 4 of 7 in “Document patch syntax.”
  1. Document patch syntax.Yann Dirson, May 12, 2007
  2. Karl HasselströmMay 12, 2007
  3. Yann DirsonMay 12, 2007
  4. Karl HasselströmMay 12, 2007
  5. Junio C HamanoMay 12, 2007
  6. Jeff KingMay 13, 2007
  7. Jeff KingMay 13, 2007

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.