diff --git a/config/largebuf.nix b/config/largebuf.nix
index 11fa1fd..e15001d 100644
--- a/config/largebuf.nix
+++ b/config/largebuf.nix
@@ -9,6 +9,8 @@
       event = "BufRead";
       group = "large_buffer_detector";
 
+      # Disable LSP, TS, syntax and some settings on large buffers
+      # Note: large_buf is set by astrocore plugin
       callback.__raw = ''
         function(args)
           if vim.b.large_buf then
diff --git a/config/options.nix b/config/options.nix
index 48b595f..696d509 100644
--- a/config/options.nix
+++ b/config/options.nix
@@ -68,7 +68,7 @@
     # Always show tabline (TODO: use with heirline?)
     #showtabline = 2;
 
-    # Show signs instead of number in gutter
+    # Show signs column
     signcolumn = "yes";
 
     # Override ignorecase if search pattern contains uppercase characters
diff --git a/plugins/astrocore/default.nix b/plugins/astrocore/default.nix
index e745e02..285e3cf 100644
--- a/plugins/astrocore/default.nix
+++ b/plugins/astrocore/default.nix
@@ -1,3 +1,4 @@
+# homepage: https://github.com/AstroNvim/astrocore
 { lib, pkgs, ... }:
 
 {
diff --git a/plugins/gitsigns.nix b/plugins/gitsigns.nix
index a66754b..2c2fcf8 100644
--- a/plugins/gitsigns.nix
+++ b/plugins/gitsigns.nix
@@ -1,3 +1,5 @@
+# homepage: https://github.com/lewis6991/gitsigns.nvim
+# nixvim doc: https://nix-community.github.io/nixvim/plugins/gitsigns/index.html
 { icons, ... }:
 
 {
@@ -5,11 +7,13 @@
     enable = true;
 
     settings = {
+      # Show line blame with custom text
       current_line_blame = true;
       current_line_blame_formatter = " <author>, <author_time:%R> – <summary>";
       current_line_blame_formatter_nc = " Uncommitted";
       current_line_blame_opts.ignore_whitespace = true;
 
+      # Use same icon for all signs (only color matters)
       signs = {
         add.text = icons.GitSign;
         change.text = icons.GitSign;
@@ -26,6 +30,7 @@
     # https://github.com/catppuccin/nvim/blob/main/lua/catppuccin/groups/integrations/gitsigns.lua
     colorschemes.catppuccin.settings.integrations.gitsigns = true;
 
+    # https://github.com/AstroNvim/AstroNvim/blob/v4.7.7/lua/astronvim/plugins/gitsigns.lua#L9-L21
     keymaps = [
       {
         key = "]g";
diff --git a/plugins/guess-indent.nix b/plugins/guess-indent.nix
index d59288c..63b70dc 100644
--- a/plugins/guess-indent.nix
+++ b/plugins/guess-indent.nix
@@ -1,3 +1,4 @@
+# homepage: https://github.com/NMAC427/guess-indent.nvim
 { pkgs, ... }:
 
 {