On 25 April 2014 11:12, Felipe Contreras wrote:
> It has been discussed many times in the past that 'index' is not an
> appropriate description for what the high-level user does with it, and
> it has been agreed that 'staging area' is the best term.
>
> The term 'staging area' is more intuitive fo
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move
away from the name "the index".
It has been discussed many times in the past that 'index' is not an
appropriate description for what the high-level user does with it, and
it has been agreed that 'staging area' is the bes
Karsten Blees wrote:
> (2) Index
>
> An index, as in a library, maps almost perfectly to what the git index is
> _and_ what we do with it.
Not really. An index in the context of a library, and in any other context, is
a tool that indicates where something is, in order to find it quickly.
That is
On Thu, 24 Oct 2013 02:57:15 +, Karsten Blees wrote:
...
> The latter. I don't know about 'broader', but I'll try to summarize _my_
> world view:
>
> (1) Audience matters
>
> For actual users, we need an accurate model that supports a variety of use
> cases without falling apart. IMO, a wor
Am 19.10.2013 16:08, schrieb Philip Oakley:
> From: "Karsten Blees"
>> Am 15.10.2013 00:29, schrieb Felipe Contreras:
>>> tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we
>>> should move
>>> away from the name "the index".
>>>
>>> It has been discussed many times in the past that
From: "Karsten Blees"
Am 15.10.2013 00:29, schrieb Felipe Contreras:
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we
should move
away from the name "the index".
It has been discussed many times in the past that 'index' is not an
appropriate description for what the high-level
Karsten Blees wrote:
> Am 15.10.2013 00:29, schrieb Felipe Contreras:
> > tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should
> > move
> > away from the name "the index".
> >
> > It has been discussed many times in the past that 'index' is not an
> > appropriate description f
Am 15.10.2013 00:29, schrieb Felipe Contreras:
> tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move
> away from the name "the index".
>
> It has been discussed many times in the past that 'index' is not an
> appropriate description for what the high-level user does with
On 17.10.2013, at 21:50, Junio C Hamano wrote:
> Felipe Contreras writes:
[...]
>
> However, since you asked, I would share a couple of comments
> regarding the index, cache and staging area.
>
> (1) "Staging area".
>
> The phrase "staging area" is not an everyday phrase or common CS
> lin
On Fri, Oct 18, 2013 at 4:46 AM, Matthieu Moy
wrote:
> I'm lacking time to read and answer in detail, sorry.
>
> Junio C Hamano writes:
>
>> "It must be done" is different from "any change is good, as long as
>> it introduces more instances of word 'stage'".
>
> I agree. Something must be done, a
On Fri, Oct 18, 2013 at 5:46 AM, Matthieu Moy
wrote:
> I'm lacking time to read and answer in detail, sorry.
>
> Junio C Hamano writes:
>
>> "It must be done" is different from "any change is good, as long as
>> it introduces more instances of word 'stage'".
>
> I agree. Something must be done, a
I'm lacking time to read and answer in detail, sorry.
Junio C Hamano writes:
> "It must be done" is different from "any change is good, as long as
> it introduces more instances of word 'stage'".
I agree. Something must be done, at least to remove the cache Vs index
confusion. I'm not sure exac
Junio C Hamano wrote:
> Felipe Contreras writes:
>
> > Junio, can you make an exception and reply to this thread? The change
> > to move away from the term "the index" has been suggested many times
> > since many years ago, it is an extremely important change to users,
> > and all the Git develop
Felipe Contreras writes:
> Junio, can you make an exception and reply to this thread? The change
> to move away from the term "the index" has been suggested many times
> since many years ago, it is an extremely important change to users,
> and all the Git developers agree it must be done.
"It mu
On Mon, Oct 14, 2013 at 5:29 PM, Felipe Contreras
wrote:
> tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move
> away from the name "the index".
Junio, can you make an exception and reply to this thread? The change
to move away from the term "the index" has been suggeste
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move
away from the name "the index".
It has been discussed many times in the past that 'index' is not an
appropriate description for what the high-level user does with it, and
it has been agreed that 'staging area' is the bes
tl;dr: everyone except Junio C Hamano and Drew Northup agrees; we should move
away from the name "the index".
It has been discussed many times in the past that 'index' is not an
appropriate description for what the high-level user does with it, and
it has been agreed that 'staging area' is the bes
On Sun, Sep 8, 2013 at 2:49 AM, Philip Oakley wrote:
> From: "Felipe Contreras"
> Sent: Sunday, September 08, 2013 2:33 AM
> [snip...]
>
>> The snapshot concept is totally orthogonal from the staging area
>> concept. Git works in snapshots, which are frozen images of how the
>> content tree was a
From: "Felipe Contreras"
Sent: Sunday, September 08, 2013 2:33 AM
[snip...]
The snapshot concept is totally orthogonal from the staging area
concept. Git works in snapshots, which are frozen images of how the
content tree was at a certain point in time; IOW; a commit.
(I feel that) In most peo
On Tue, Sep 3, 2013 at 11:45 PM, Drew Northup wrote:
> On Thu, Aug 29, 2013 at 6:10 PM, Felipe Contreras
> wrote:
>> On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote:
>>> On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote:
Felipe Contreras writes:
> It has been discussed ma
On Tue, Sep 3, 2013 at 11:23 PM, Drew Northup wrote:
> On Fri, Aug 30, 2013 at 1:16 AM, Piotr Krukowiecki
> wrote:
>> Drew Northup napisał:
>>>I agree with Junio. This effort is better spent making the
>>>documentation clearer and more succinct. The reality is that a user
>>>needs to build a mod
On Wed, Sep 4, 2013 at 8:36 AM, Drew Northup wrote:
> On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki
> wrote:
>> Just wanted to point to a Dr. Dobb's article from Monday:
>> http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2
>>
>> The author does not use the
On Wed, Sep 4, 2013 at 2:13 AM, Piotr Krukowiecki
wrote:
> Just wanted to point to a Dr. Dobb's article from Monday:
> http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2
>
> The author does not use the use the word "index" at all. Instead he
> writes in followin
On 6 September 2013 08:45, Ping Yin wrote:
> On Wed, Sep 4, 2013 at 2:08 PM, William Swanson wrote:
>> On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras
>> wrote:
>>> It has been discussed many times in the past that 'index' is not an
>>> appropriate description for what the high-level user doe
On Wed, Sep 4, 2013 at 2:08 PM, William Swanson wrote:
> On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras
> wrote:
>> It has been discussed many times in the past that 'index' is not an
>> appropriate description for what the high-level user does with it, and
>> it has been agreed that 'staging
On Wed, Sep 4, 2013 at 3:13 AM, Piotr Krukowiecki
wrote:
> Just wanted to point to a Dr. Dobb's article from Monday:
> http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2
>
> The author does not use the use the word "index" at all. Instead he
> writes in followin
Just wanted to point to a Dr. Dobb's article from Monday:
http://www.drdobbs.com/tools/getting-started-with-git-the-fundamental/240160261?pgno=2
The author does not use the use the word "index" at all. Instead he
writes in following way:
---
On Thu, Aug 29, 2013 at 11:01 AM, Felipe Contreras
wrote:
> It has been discussed many times in the past that 'index' is not an
> appropriate description for what the high-level user does with it, and
> it has been agreed that 'staging area' is the best term.
I realize Git is not a democracy, but
On Thu, Aug 29, 2013 at 6:10 PM, Felipe Contreras
wrote:
> On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote:
>> On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote:
>>> Felipe Contreras writes:
>>>
It has been discussed many times in the past that 'index' is not an
appropriate de
On Fri, Aug 30, 2013 at 1:16 AM, Piotr Krukowiecki
wrote:
> Drew Northup napisał:
>>I agree with Junio. This effort is better spent making the
>>documentation clearer and more succinct. The reality is that a user
>>needs to build a model in their mind of what they are doing which maps
>>enough (c
On Sat, Aug 31, 2013 at 12:46 AM, René Scharfe wrote:
> Am 29.08.2013 22:36, schrieb Felipe Contreras:
>>
>> On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote:
>>>
>>> If you have a --work-tree option then parseopt accepts --work as well,
>>> unless it's ambiguous, i.e. another option starts wi
On Sat, Aug 31, 2013 at 2:46 AM, René Scharfe wrote:
> Am 29.08.2013 22:36, schrieb Felipe Contreras:
>>
>> On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote:
>>>
>>> If you have a --work-tree option then parseopt accepts --work as well,
>>> unless it's ambiguous, i.e. another option starts wit
Am 29.08.2013 22:36, schrieb Felipe Contreras:
On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote:
If you have a --work-tree option then parseopt accepts --work as well,
unless it's ambiguous, i.e. another option starts with --work, too. So you
can have a descriptive, extra-long option and ty
On Fri, Aug 30, 2013 at 3:40 PM, Felipe Contreras
wrote:
> On Fri, Aug 30, 2013 at 2:11 PM, Felipe Contreras
> wrote:
>> On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras
>> wrote:
>
>>> Here are the threads once again:
>>>
>>> http://thread.gmane.org/gmane.comp.version-control.git/197111
>>> ht
On Fri, Aug 30, 2013 at 2:11 PM, Felipe Contreras
wrote:
> On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras
> wrote:
>> Here are the threads once again:
>>
>> http://thread.gmane.org/gmane.comp.version-control.git/197111
>> http://thread.gmane.org/gmane.comp.version-control.git/166675
>> http:/
On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras
wrote:
> On Thu, Aug 29, 2013 at 1:37 PM, Junio C Hamano wrote:
>> IIRC, when this was discussed, many non-native speakers had trouble
>> with the verb "to stage", not just from i18n/l10n point of view.
>
> Well, you recall incorrectly.
>
> There
On Thu, Aug 29, 2013 at 2:57 PM, Felipe Contreras
wrote:
> Again, *everyone* has agreed that index needs to be renamed, and
> "staging area" is the best option.
>
> Do I really need to go through all the discussions and list each and
> every person that participated in them, and show to you how e
Drew Northup napisał:
>I agree with Junio. This effort is better spent making the
>documentation clearer and more succinct. The reality is that a user
>needs to build a model in their mind of what they are doing which maps
>enough (completely is not required) to what is actually going on to
>get w
On Thu, Aug 29, 2013 at 4:55 PM, Drew Northup wrote:
> On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote:
>> Felipe Contreras writes:
>>
>>> It has been discussed many times in the past that 'index' is not an
>>> appropriate description for what the high-level user does with it, and
>>> it h
On Thu, Aug 29, 2013 at 2:37 PM, Junio C Hamano wrote:
> Felipe Contreras writes:
>
>> It has been discussed many times in the past that 'index' is not an
>> appropriate description for what the high-level user does with it, and
>> it has been agreed that 'staging area' is the best term.
>
> "add
Felipe Contreras writes:
> Matthieu Moy wrote:
>
>> --work alone sounds weird. At least to me, it does not immediately imply
>> "working tree". It is tempting to call the option --work-tree, but git
>> already has a global option with that name (git --work-tree=foo bar).
>
> Yes, --work sounds we
On Thu, Aug 29, 2013 at 3:03 PM, René Scharfe wrote:
> Am 29.08.2013 20:57, schrieb Felipe Contreras:
>>
>> Matthieu Moy wrote:
>>
>>> Felipe Contreras writes:
Moreover, the --stage and --work
>>>
>>>
>>> --work alone sounds weird. At least to me, it does not immediately imply
>>> "work
Am 29.08.2013 20:57, schrieb Felipe Contreras:
Matthieu Moy wrote:
Felipe Contreras writes:
Moreover, the --stage and --work
--work alone sounds weird. At least to me, it does not immediately imply
"working tree". It is tempting to call the option --work-tree, but git
already has a global op
On Thu, Aug 29, 2013 at 1:37 PM, Junio C Hamano wrote:
> Felipe Contreras writes:
>
>> It has been discussed many times in the past that 'index' is not an
>> appropriate description for what the high-level user does with it, and
>> it has been agreed that 'staging area' is the best term.
>
> "add
Felipe Contreras writes:
> add an explanation in Documentation/gitstagingarea.txt
> or something.
There's Documentation/gitcli.txt, that will need updating anyway (at the
bottom, it talks about --cached and --index).
--
Matthieu Moy
http://www-verimag.imag.fr/~moy/
--
To unsubscribe from this
Felipe Contreras writes:
> Matthieu Moy wrote:
>> These explanations make sense. I think it would be better to put part of
>> it in commit messages, so that future contributors can "git blame" the
>> doc/implem of these --stage and find them (i.e. avoid the
>> misunderstanding that occured with "
Matthieu Moy wrote:
> Felipe Contreras writes:
>
> > It has been discussed many times in the past that 'index' is not an
> > appropriate description for what the high-level user does with it, and
> > it has been agreed that 'staging area' is the best term.
>
> Thanks for working on this. No time
Felipe Contreras writes:
> It has been discussed many times in the past that 'index' is not an
> appropriate description for what the high-level user does with it, and
> it has been agreed that 'staging area' is the best term.
Thanks for working on this. No time for a really detailed review, but
Felipe Contreras writes:
> It has been discussed many times in the past that 'index' is not an
> appropriate description for what the high-level user does with it, and
> it has been agreed that 'staging area' is the best term.
"add" is the verb, not "index" (which is a noun that refers
to the th
Hi,
It has been discussed many times in the past that 'index' is not an
appropriate description for what the high-level user does with it, and
it has been agreed that 'staging area' is the best term.
The term 'staging area' is more intuitive for newcomers which are more
familiar with English than
50 matches
Mail list logo