Thread (23 messages) 23 messages, 5 authors, 2025-08-29
STALE292d
Revisions (2)
  1. v1 [diff vs current]
  2. v2 current

[PATCH v2 4/4] doc: git-add: explain inconsistent terminology

From: Julia Evans via GitGitGadget <hidden>
Date: 2025-08-13 23:20:25
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

From: Julia Evans <redacted>

I think the fact that git uses these three terms interchangeably is
extremely confusing and that it deserves to be noted.

Signed-off-by: Julia Evans <redacted>
---
 Documentation/git-add.adoc | 4 ++++
 1 file changed, 4 insertions(+)
diff --git a/Documentation/git-add.adoc b/Documentation/git-add.adoc
index 6a6f5223419f..0b887e1d60ca 100644
--- a/Documentation/git-add.adoc
+++ b/Documentation/git-add.adoc
@@ -45,6 +45,10 @@ exact filename of an ignored file (e.g. `git add ignored.txt`), `git
 add` will fail with a list of ignored files. Otherwise it will silently
 ignore the file.
 
+[NOTE]
+Git uses the terms "staging area", "index" and "cache" interchangeably
+for historical reasons.
+
 OPTIONS
 -------
 `<pathspec>...`::
-- 
gitgitgadget
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help