From d39227d0b82430b210a51472ca65a5af9bd2ee3d Mon Sep 17 00:00:00 2001
From: Hong Xu <hong@topbug.net>
Date: Dec 21 2024 21:43:50 +0000
Subject: [PATCH 1/5] Document that git index version must be <= 2


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index dffb9c4..411a473 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -63,3 +63,24 @@ $ koji moshimoshi
 You are using the hub at https://koji.fedoraproject.org/kojihub
 Authenticated via GSSAPI
 ----
+
+=== Git Index Version
+
+Some tools only works with git repos with index version <= 2. You can check
+the index version of the working repo by running
+
+---
+$ git update-index --show-index-version
+---
+
+If it outputs a number larger than 2, you can change the index version to 2:
+
+---
+$ git update-index --index-version 2
+---
+
+To change the default git index for future git repositories, run
+
+---
+$ git config --global index.version 2
+---
\ No newline at end of file

From f14cb4ab0c783d9d0634e9a0ae639b9d6203627c Mon Sep 17 00:00:00 2001
From: Hong Xu <hong@topbug.net>
Date: Dec 21 2024 21:46:24 +0000
Subject: [PATCH 2/5] Grammar fixes


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index 411a473..6a961b1 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -66,8 +66,8 @@ Authenticated via GSSAPI
 
 === Git Index Version
 
-Some tools only works with git repos with index version <= 2. You can check
-the index version of the working repo by running
+Some tools only work with git repositories with index version <= 2.
+You can check the index version of the working repo by running
 
 ---
 $ git update-index --show-index-version

From 42abe3ded64687dcbbca70c26a14f5d018de85ef Mon Sep 17 00:00:00 2001
From: Hong Xu <hong@topbug.net>
Date: Dec 26 2024 08:08:46 +0000
Subject: [PATCH 3/5] Add an example tool


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index 6a961b1..3203550 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -66,8 +66,9 @@ Authenticated via GSSAPI
 
 === Git Index Version
 
-Some tools only work with git repositories with index version <= 2.
-You can check the index version of the working repo by running
+Some tools, such as `fedpkg mockbuild`, only work with git repositories with
+index version <= 2. You can check the index version of the working repo by
+running
 
 ---
 $ git update-index --show-index-version

From af31d3c040b627a209b8f1a8b8e388bd41a9574c Mon Sep 17 00:00:00 2001
From: Hong Xu <hong@topbug.net>
Date: Dec 29 2024 21:54:20 +0000
Subject: [PATCH 4/5] New line for every period


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index 3203550..a3b6628 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -67,8 +67,8 @@ Authenticated via GSSAPI
 === Git Index Version
 
 Some tools, such as `fedpkg mockbuild`, only work with git repositories with
-index version <= 2. You can check the index version of the working repo by
-running
+index version <= 2.
+You can check the index version of the working repo byrunning
 
 ---
 $ git update-index --show-index-version

From 675ca1ce5140cd2f8f86f5b9d28ef57aaaddb55a Mon Sep 17 00:00:00 2001
From: Hong Xu <hong@topbug.net>
Date: Dec 29 2024 21:58:33 +0000
Subject: [PATCH 5/5] Explain the consequence of using git index version 2 by default


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index a3b6628..7145843 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -80,7 +80,8 @@ If it outputs a number larger than 2, you can change the index version to 2:
 $ git update-index --index-version 2
 ---
 
-To change the default git index for future git repositories, run
+Globally, https://git-scm.com/docs/git-update-index#Documentation/git-update-index.txt---index-versionltngt[Git defaults to an index version based on the feature used].
+If you are comfortable with using Git index version 2 by default for future Git repositories, run
 
 ---
 $ git config --global index.version 2