docs: update differences-from-git to be more concise

2 files changed, 20 insertions, 40 deletions

diff --git a/docs/differences-from-git-cli.md b/docs/differences-from-git-cli.md
deleted file mode 100644
index 46e823ac8..000000000
--- a/docs/differences-from-git-cli.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# Differences from the Git CLI
-
-In some instances, the functionality of libgit2 deviates slightly from that of the Git CLI. This can because of technical limitations when developing a library, licensing limitations when converting functionality from the CLI to libgit2, or various other reasons.
-
-Repository and Workdir Path Reporting
--------------------------------------
-
-When retrieving the absolute path of a repository from the Git CLI, one could expect the output to lool like so:
-
-```
-$ git rev-parse --absolute-git-dir
-=> /home/user/projects/libgit2/.git
-```
-
-When retrieving the absolute path of a repository from libgit2, one could expect the output to look like:
-
-```
-const char *repo_path = git_repository_path(repo);
-printf(repo_path);
-=> /home/user/projects/libgit2/.git/
-```
-
-Notice the trailing slash. While it would be nice to be able to remove the trailing slash from the `git_repository_path` return value, it is considered a breaking change to do so, and relatively high risk for the benefit.
-
-Retrieving the absolute path to the working directory suffers from the same problem.
-
-Git CLI:
-
-```bash
-$ git worktree list
-=> /home/user/projects/libgit2
-```
-
-libgit2:
-
-```c
-const char *workdir_path = git_repository_workdir(repo);
-printf(workdir_path);
-=> /home/user/projects/libgit2/
-```
diff --git a/docs/differences-from-git.md b/docs/differences-from-git.md
new file mode 100644
index 000000000..feec5c115
--- /dev/null
+++ b/docs/differences-from-git.md
@@ -0,0 +1,20 @@
+# Differences from Git
+
+In some instances, the functionality of libgit2 deviates slightly from Git. This can be because of technical limitations when developing a library, licensing limitations when converting functionality from Git to libgit2, or various other reasons.
+
+Repository and Workdir Path Reporting
+-------------------------------------
+
+When asking Git for the absolute path of a repository via `git rev-parse --absolute-git-dir`, it will output the path to the ".git" folder without a trailing slash. In contrast to that, the call `git_repository_path(repo)` will return the path with a trailing slash:
+
+```
+git rev-parse --absolute-git-dir -> /home/user/projects/libgit2/.git
+git_repository_path(repo) -> /home/user/projects/libgit2/.git/
+```
+
+The same difference exists when listing worktrees:
+
+```
+git worktree list -> /home/user/projects/libgit2
+git_repository_workdir(repo) -> /home/user/projects/libgit2/
+```