From: Andreas Ericsson <ae@op5.se>
To: Sebastian Morr <sebastian@morr.cc>
Cc: git@vger.kernel.org
Subject: Re: Is it "GIT" or "Git" or "git"? Standardize documentation?
Date: Wed, 14 Dec 2011 02:01:21 +0100 [thread overview]
Message-ID: <4EE7F561.2040601@op5.se> (raw)
In-Reply-To: <20111214004332.GA8464@thinkpad>
On 12/14/2011 01:43 AM, Sebastian Morr wrote:
> Okay, I'd like to hear opinions on this before creating a patch.
>
> My perception is that "Git" is the name of the software, whereas "git"
> is used to refer to the actual command. But "GIT" is all over the
> documentation as well, most prominently at the top of README.
> Would anyone mind if we replaced all occurrences of "GIT" in the
> documentation with "Git"?
> I suppose the release notes shouldn't be touched for historical reasons.
>
I doubt anyone cares all that much. I for one have absolutely no clue
what you're talking about, but if you think it looks better one way
than the other and care about it enough, just make the patch and send
it in for review. Consensus is never reached before there's code, and
hardly ever after either, but discussing something that *might* happen
and still doesn't affect my daily life feels utterly pointless.
> Completely unrelated: Why is it "Documentation/RelNotes" and not
> something like "documentation/release-notes"? Almost everything else is
> spelled either all-lower- or all-uppercase.
>
For tab-completion and directory listing reasons. Uppercase-D+tab puts
you in the right directory and uppercasing RelNotes makes it easy to
find among its many companions in that directory. It's fairly standard
procedure in the unix world to uppercase or camelcase the more important
documents, and especially when there's more than a small handful of files
in a single directory.
--
Andreas Ericsson andreas.ericsson@op5.se
OP5 AB www.op5.se
Tel: +46 8-230225 Fax: +46 8-230231
Considering the successes of the wars on alcohol, poverty, drugs and
terror, I think we should give some serious thought to declaring war
on peace.
next prev parent reply other threads:[~2011-12-14 1:01 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-12-14 0:43 Is it "GIT" or "Git" or "git"? Standardize documentation? Sebastian Morr
2011-12-14 1:01 ` Andreas Ericsson [this message]
2011-12-14 1:02 ` Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4EE7F561.2040601@op5.se \
--to=ae@op5.se \
--cc=git@vger.kernel.org \
--cc=sebastian@morr.cc \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).