style: align comments with the project conventions

Apply a codebase-wide comment audit against the comment conventions:
split banned semicolons and multi-sentence lines into one sentence per
line, cut cross-file and history narration, trim file-top headers to a
single purpose line, and drop verbosity that did not earn its place.
Prose docs (CLAUDE.md, install.md) get the same one-sentence-per-line
and no-semicolon treatment.

modules/nvim/config.lua

@@ -1,13 +1,12 @@
--- Imperative configuration that has no typed nixvim option: the colorscheme
--- call and two autocmds. Everything expressible as Nix lives in ./nvim.nix.
+-- Imperative configuration that has no typed nixvim option: the colorscheme call and autocmds.
 
--- gbprod/nord.nvim, provided as an extra plugin from nixpkgs.
+-- gbprod/nord.nvim.
 require("nord").setup({
   transparent = true,
 })
 vim.cmd.colorscheme("nord")
 
--- Conceal markdown syntax in markdown buffers (previously an after/ftplugin).
+-- Conceal markdown syntax in markdown buffers.
 -- conceallevel is window-local, so it is set with opt_local when the filetype
 -- is applied to the buffer's window.
 vim.api.nvim_create_autocmd("FileType", {

modules/nvim/nvim.nix

@@ -5,8 +5,7 @@
   inputs,
   ...
 }:
-# Neovim for the primary user, configured declaratively through nixvim. The
-# imperative remainder (colorscheme, Neogit blame autocmd) lives in ./config.lua.
+# Neovim for the primary user, configured declaratively through nixvim.
 let
   cfg = config.modules.nvim;
   user = config.user.name;
@@ -176,8 +175,8 @@ in
           };
         };
 
-        # gbprod/nord.nvim (nixvim's colorschemes.nord is a different plugin);
-        # set up in ./config.lua.
+        # gbprod/nord.nvim, set up in ./config.lua.
+        # nixvim's colorschemes.nord is a different plugin.
         extraPlugins = [ pkgs.vimPlugins.gbprod-nord ];
 
         extraConfigLua = builtins.readFile ./config.lua;