Re: Suggestions to make git easier to understand

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Aug 11, 2011, 22:16 UTC
Message-ID: <20110811221627.GA32005@elie.gateway.2wire.net>
In-Reply-To: <CAGK7Mr5T4-DBK7rXeH-1=SNu5HBOEkLBW=CAh5Lhf7oHKjFAiw@mail.gmail.com>

Hi Philippe,

Philippe Vaucher wrote:

Show 5 quoted lines

> http://raflabs.com/blogs/silence-is-foo/2011/04/07/staging-area-index-cache-git/
>
> I thought it made some good points about git being kinda confusing,
> for example sentences like "Changed but not updated" in git status
> could use a better sentence like "Changed but not in the index".

Sounds reasonable (well, with some more precise wording to reflect that this means "changed but not all changes are reflected in the index").

Show 9 quoted lines

> Maybe
> --cached could have an alias like --index-only for things to be more
> intuitive as well.
> 
> `git rm --index-only somefile` is more understandable than `git rm
> --cached somefile` imho.
> 
> Also, in ls-files, --stage could maybe use an alias like --contents
> for it to be more self-explanatory.

These suggestions also seem sane. Please send patches (Documentation/SubmittingPatches explains how) so we can refine them and fix this.

Thanks much, Jonathan