From 9bb15e9ffbf43663a77949ea31d6f18c74e8981c Mon Sep 17 00:00:00 2001
From: Roman Perepelitsa <roman.perepelitsa@gmail.com>
Date: Wed, 26 Jul 2023 19:24:52 +0200
Subject: [PATCH] docs: rephrase "Git status looks incorrect" section

---
 README.md | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index fa5fa26..5fa806c 100644
--- a/README.md
+++ b/README.md
@@ -1511,7 +1511,7 @@ Powerlevel10k are released. This may change in the future but not soon.
 - [Horrific mess when resizing terminal window](#horrific-mess-when-resizing-terminal-window)
 - [Icons cut off in Konsole](#icons-cut-off-in-konsole)
 - [Arch Linux logo has a dot in the bottom right corner](#arch-linux-logo-has-a-dot-in-the-bottom-right-corner)
-- [Git status looks incorrect](#git-status-looks-incorrect)
+- [Incorrect git status in prompt](#incorrect-git-status-in-prompt)
 
 ### Question mark in prompt
 
@@ -2022,14 +2022,15 @@ Some fonts have this incorrect dotted icon in bold typeface. There are two ways
 typeset -g POWERLEVEL9K_OS_ICON_CONTENT_EXPANSION='${P9K_CONTENT}'  # not bold
 ```
 
-### Git status looks incorrect
+### Incorrect git status in prompt
 
-Powerlevel10k uses [gitstatus](https://github.com/romkatv/gitstatus) to provide a much faster response to traditional `git status`.
-The project relies on the [libgit2](https://github.com/libgit2/libgit2) library however which has some gaps in it's implementation.
+Powerlevel10k uses [gitstatusd](https://github.com/romkatv/gitstatus) to inspect the state of git
+repositories. The project relies on the [libgit2](https://github.com/libgit2/libgit2) library, which
+has some gaps in its implementation. Under some conditions, this may result in discrepancies between
+the real state of a git repository (reflected by `git status`) and what gets shown in the
+Powerlevel10k prompt.
 
-#### skipHash not supported
-
-If your `.git/config` has `skipHash` enabled, then you will likely see an incorrect status prompt as this is not supported
-by libgit2 at the moment. [issue](https://github.com/libgit2/libgit2/issues/6531)
-
-Note: `skipHash` can be set by implicitly by other configuration toggles such as `feature.manyFiles`
+Most notably, [libgit2 does not support `skipHash`](https://github.com/libgit2/libgit2/issues/6531).
+If you see incorrect git status in prompt, run `git config -l` and check whether `skipHash` is
+enabled. If it is, consider disabling it. Keep in mind that `skipHash` may be implicitly enabled
+when activating ceratin git features, such as `manyFiles`.