More commenting of Neovim config

Author: notahat

config/nvim/lua/plugin-specs/lsp/lspconfig-config.lua

@@ -1,8 +1,12 @@
+-- Configure nvim-lspconfig to use the language servers I want.
 return function()
     local lspconfig = require("lspconfig")
-    local capabilities = require("cmp_nvim_lsp").default_capabilities()
 
+    -- The language servers need to know what capabilities our completion
+    -- system supports. This fetches the capabilities to pass along to them.
+    local capabilities = require("cmp_nvim_lsp").default_capabilities()
     local opts = { capabilities = capabilities }
+
     local dotfiles_env = os.getenv("DOTFILES_ENV")
 
     if dotfiles_env == "home" then
@@ -28,6 +32,6 @@ return function()
     vim.fn.sign_define("DiagnosticSignInfo", { text = "󰋽 ", texthl = "DiagnosticSignInfo" })
     vim.fn.sign_define("DiagnosticSignHint", { text = "󰌶", texthl = "DiagnosticSignHint" })
 
-    -- Language servers can be configured on a per-project basis using exrc.
-    -- See the .nvim.lua file in .dotfiles for an example.
+    -- Language servers can also be configured on a per-project basis using
+    -- exrc. See the .nvim.lua file in .dotfiles for an example.
 end

config/nvim/lua/plugin-specs/lsp/null-ls-config.lua

@@ -1,3 +1,5 @@
+-- Configure none-ls to use the formatters I want, and set it up to auto-format
+-- on save.
 return function()
     local null_ls = require("null-ls")
     local formatting = null_ls.builtins.formatting
@@ -7,9 +9,7 @@ return function()
 
     if dotfiles_env == "home" then
         sources = {
-            formatting.prettierd.with({
-                disabled_filetypes = { "ruby" },
-            }),
+            formatting.prettierd,
             formatting.stylua,
         }
     end
@@ -28,6 +28,8 @@ return function()
 
     null_ls.setup({
         sources = sources,
+        -- This sets up auto-formatting on save. Taken from:
+        -- https://github.com/jose-elias-alvarez/null-ls.nvim/wiki/Formatting-on-save
         on_attach = function(client, bufnr)
             if client.supports_method("textDocument/formatting") then
                 vim.api.nvim_clear_autocmds({ group = augroup, buffer = bufnr })