On 2019-09-15 at 22:18:07, Junio C Hamano wrote: > "brian m. carlson" writes: > > diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt > > index 4b90b9c12a..34a8496b0e 100644 > > --- a/Documentation/git-commit-tree.txt > > +++ b/Documentation/git-commit-tree.txt > > @@ -92,6 +92,12 @@ if set: > > > > (nb "<", ">" and "\n"s are stripped) > > > > +The author and committer names are by convention some form of a personal name, > > +as opposed to a username, although Git does not enforce or require any > > +particular form. > > I have a lot of trouble with 'username' in the context of this > paragraph. > > After all, you are describing the name appropriate to be set as the > value of the user.name configuration, and you are trying to stress > that the name used there is different from and has nothing to do > with the name machines use to identify the user. In the paragraph > that follows this new paragraph, there is a reference to "system > user name", which is still not great but probably better than > "username" above. Perhaps there is a term that is distinct enough > from "user name" that is commonly used I am forgetting? I am almost > tempted to say "user id", but there must be even better phrases. I > dunno. I wonder if we should just omit that aside, then, since I'm not sure of a less ambiguous term for "how I identify myself to a computer". I think describing the convention as "some form of a personal name" is probably sufficient to tell people what we suggest they do. My first draft of that sentence didn't include the part within the commas at all. -- brian m. carlson: Houston, Texas, US OpenPGP: https://keybase.io/bk2204