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

From: "Julia Evans via GitGitGadget" <[email-masked]>
Date: Wed, 13 Aug 2025 23:20:18 +0000

From: Julia Evans <[email-masked]>

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 <[email-masked]>
---
 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