basics: navigate git hunks with gitsigns key mappings

Resolve: #57
practicalli · Jan 23, 2025 · 52a5dcb · 52a5dcb
1 parent 8badec8
commit 52a5dcb
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -26,6 +26,7 @@
 - source-control: new magit screenshots & gitlinker plugin use
 - reference: started folding page
 - clojure: refactor namespace with Clojure LSp via command line
+- basics: navigate git hunks with gitsigns key mappings
 
 ### Changed
 - ci: spell lychee & repository trufflehog linters warn only (false positives)

diff --git a/docs/neovim-basics/navigation.md b/docs/neovim-basics/navigation.md
@@ -157,6 +157,20 @@ Navigate within the current file or globally using file marks.
 > AstroNvim user config enables `incsearch` incremental search and `hlsearch` to highlight every search match
 
 
+## Git
+
+AstroNvim includes [Gitsigns](https://github.com/lewis6991/gitsigns.nvim) which highlights changes to the working directory in the buffer margin.
+
+Git hunks can be navigated
+
+- ++bracket-left++ ++"g"++ jumps to previous hunk
+- ++bracket-right++ ++"g"++ jumps to next hunk
+- ++bracket-left++ ++"G"++ jumps to first hunk
+- ++bracket-right++ ++"G"++ jumps to last hunk
+
+> [Source Control](/neovim/source-control/index.md) section describes additional features of Gitsigns and other Git tools.
+
+
 ## Projects
 
 ++colon++ ++"c"++ ++"d"++ followed by a path changes the root directory for Neovim.