Re: [PATCH] Document patch syntax.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 2007-05-12 16:38:27 +0200, Yann Dirson wrote:

> 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@xxxxxxxxxxx
      www.treskal.com/kalle
-
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux