a little cleanup

lua/plugins.lua

@@ -40,39 +40,47 @@ packer.startup(function(use)
 	-- actual plugins list
 	use("wbthomason/packer.nvim")
 
+	-- telescope: highly extendable fuzzy finder over lists
+	-- https://github.com/nvim-telescope/telescope.nvim
 	use({
 		"nvim-telescope/telescope.nvim",
 		requires = { { "nvim-lua/popup.nvim" }, { "nvim-lua/plenary.nvim" } },
 		config = get_config("telescope"),
 	})
-
+	-- zoxide helps jump to folders
 	use({ "jvgrootveld/telescope-zoxide" })
+        -- An extension for telescope.nvim that allows you to switch between document's headings.
 	use({ "crispgm/telescope-heading.nvim" })
+	-- provide its users with the ability of picking symbols and insert them at point
 	use({ "nvim-telescope/telescope-symbols.nvim" })
 	use({ "nvim-telescope/telescope-file-browser.nvim" })
+	-- file browser extension for telescope.nvim. It supports synchronized creation, deletion, renaming, and moving of files and folders powered by telescope.nvim and plenary.nvim.
 	use({ "nvim-telescope/telescope-fzf-native.nvim", run = "make" })
+	-- Integration for packer.nvim with telescope.nvim.
 	use({ "nvim-telescope/telescope-packer.nvim" })
+	-- sets vim.ui.select to telescope. That means for example that neovim core stuff can fill the telescope picker
 	use({ "nvim-telescope/telescope-ui-select.nvim" })
-
+	-- File Explorer
 	use({ "kyazdani42/nvim-tree.lua", config = get_config("nvim-tree") })
-
+	-- Smoothly navigate between splits and panes
+	-- https://github.com/numToStr/Navigator.nvim
 	use({ "numToStr/Navigator.nvim", config = get_config("navigator") })
-
+	-- Neovim statusline
 	use({
 		"nvim-lualine/lualine.nvim",
 		config = get_config("lualine"),
 		event = "VimEnter",
 		requires = { "kyazdani42/nvim-web-devicons", opt = true },
 	})
-
+	-- A high-performance color highlighter for Neovim which has no external dependencies
 	use({
 		"norcalli/nvim-colorizer.lua",
 		event = "BufReadPre",
 		config = get_config("colorizer"),
 	})
-
+	-- autopair plugin for Neovim that supports multiple characters
 	use({ "windwp/nvim-autopairs", config = get_config("nvim-autopairs") })
-
+	-- fast parser for doing lookups per keystroke
 	use({
 		"nvim-treesitter/nvim-treesitter",
 		config = get_config("treesitter"),
@@ -82,7 +90,7 @@ packer.startup(function(use)
 	-- use("nvim-treesitter/nvim-treesitter-textobjects")
 
 	-- use("RRethy/nvim-treesitter-endwise")
-
+	-- A completion engine plugin for neovim
 	use({
 		"hrsh7th/nvim-cmp",
 		requires = {
@@ -97,7 +105,7 @@ packer.startup(function(use)
 		},
 		config = get_config("cmp"),
 	})
-
+	-- community driven repository for all kinds of snippets in all programming languages
 	use({ "rafamadriz/friendly-snippets" })
 	use({
 		"L3MON4D3/LuaSnip",
@@ -117,6 +125,7 @@ packer.startup(function(use)
 		config = get_config("diffview"),
 	})
 
+	-- some tui? for git in neovim?
 	use({
 		"TimUntersberger/neogit",
 		requires = { "nvim-lua/plenary.nvim" },
@@ -124,6 +133,7 @@ packer.startup(function(use)
 		config = get_config("neogit"),
 	})
 
+	-- probably does git blame
 	use({ "f-person/git-blame.nvim", config = get_config("git-blame") })
 
 	use({
@@ -133,13 +143,13 @@ packer.startup(function(use)
 		config = get_config("gitsigns"),
 	})
 
-	-- use("p00f/nvim-ts-rainbow")
-
+	-- make Neovim's quickfix window better
 	use({
 		"kevinhwang91/nvim-bqf",
 		requires = { { "junegunn/fzf", module = "nvim-bqf" }, config = get_config("nvim-bqf") },
 	})
 
+	-- tab labels
 	use({
 		"akinsho/nvim-bufferline.lua",
 		requires = "kyazdani42/nvim-web-devicons",
@@ -147,10 +157,12 @@ packer.startup(function(use)
 		config = get_config("bufferline"),
 	})
 
+	-- delete a buffer without messing up your window layout
 	use("famiu/bufdelete.nvim")
 
 	use({ "neovim/nvim-lspconfig", config = get_config("lsp") })
 
+	-- adds vscode-like pictograms
 	use({ "onsails/lspkind-nvim", requires = { "famiu/bufdelete.nvim" } })
 
 	-- use({
@@ -159,48 +171,63 @@ packer.startup(function(use)
 	-- 	config = get_config("null-ls"),
 	-- })
 
+	-- A tree like view for symbols
 	use({
 		"simrat39/symbols-outline.nvim",
 		cmd = { "SymbolsOutline" },
 		config = get_config("symbols"),
 	})
 
+	-- adds indentation guides to all lines
 	use({
 		"lukas-reineke/indent-blankline.nvim",
 		event = "BufReadPre",
 		config = [[require("config/indent-blankline")]],
 	})
 
-	use({
-		"akinsho/nvim-toggleterm.lua",
-		keys = { "<C-n>", "<leader>fl", "<leader>gt" },
-		config = get_config("toggleterm"),
-	})
+	-- use({
+	-- 	"akinsho/nvim-toggleterm.lua",
+	-- 	keys = { "<C-n>", "<leader>fl", "<leader>gt" },
+	-- 	config = get_config("toggleterm"),
+	-- })
 
+	-- highlights todos
 	use({
 		"folke/todo-comments.nvim",
 		requires = "nvim-lua/plenary.nvim",
 		config = get_config("todo"),
 	})
 
+	-- some kinda project management
+	-- https://github.com/ahmedkhalf/project.nvim
 	use({ "ahmedkhalf/project.nvim", config = get_config("project") })
 
+	-- text highlighting
 	use("ironhouzi/starlite-nvim")
 
+	-- popup with possible key bindings of the command you started typing
 	use({ "folke/which-key.nvim", config = get_config("which-key") })
 
+	-- alignment
 	use("junegunn/vim-easy-align") -- no lua alternative, https://github.com/Vonr/align.nvim not working for me
 
+	--
+	-- literally a grammer checker
+	-- https://github.com/rhysd/vim-grammarous
 	use({ "rhysd/vim-grammarous", cmd = "GrammarousCheck" })
 
+	-- automatically highlighting other uses of the current word under the cursor
+	-- https://github.com/RRethy/vim-illuminate
 	use({ "RRethy/vim-illuminate" })
 
+	-- lf is a terminal file manager
 	use({
 		"ptzz/lf.vim",
 		requires = "voldikss/vim-floaterm",
 		config = get_config("lf"),
 	})
 
+	-- themes
 	if settings.theme == "nightfox" then
 		use({ "EdenEast/nightfox.nvim", config = get_config("nightfox") })
 	elseif settings.theme == "catppuccino" then
@@ -209,6 +236,7 @@ packer.startup(function(use)
 		use({ "catppuccin/nvim", as = "catppuccin", config = get_config("catppuccin") })
 	end
 
+	-- 
 	use({
 		"ThePrimeagen/harpoon",
 		requires = { "nvim-lua/plenary.nvim" },
@@ -264,8 +292,3 @@ packer.startup(function(use)
 		end,
 	})
 end)
-
--- TODO: ????
--- use {"lukas-reineke/headlines.nvim", config = get_config("headlines")}
--- https://github.com/glepnir/lspsaga.nvim
--- use 'glepnir/lspsaga.nvim'