From 09d51da39d01843011ab8e1206da5fe90de8d8f9 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 24 May 2026 16:13:08 -0500
Subject: docs(init): retire stale module comments and track follow-ups

Three init.el requires carried vague comments: latex-config "WIP need to fix", prog-shell "combine elsewhere", and a "Modules In Test" banner. I replaced them with descriptive comments and moved the real follow-up work into todo.org tasks: investigate the latex-config state, and decide whether prog-shell config folds into prog-general. I also marked the module-classification task DOING.
---
 init.el  | 6 +++---
 todo.org | 8 +++++++-
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/init.el b/init.el
index 19d8e269..57dd735a 100644
--- a/init.el
+++ b/init.el
@@ -91,7 +91,7 @@
 (require 'eww-config)            ;; text mode web browsing, w/o javascript
 (require 'flyspell-and-abbrev)   ;; spell check and auto-correct
 (require 'httpd-config)
-(require 'latex-config)          ;; WIP need to fix
+(require 'latex-config)          ;; LaTeX/AUCTeX editing configuration
 (require 'mail-config)           ;; email using mu4e and org-msg
 (require 'markdown-config)
 (require 'pdf-config)            ;; pdf display settings
@@ -110,7 +110,7 @@
 (require 'prog-c)
 (require 'prog-go)
 (require 'prog-lisp)
-(require 'prog-shell)            ;; combine elsewhere
+(require 'prog-shell)            ;; shell-script editing configuration
 (require 'prog-python)
 (require 'prog-webdev)
 (require 'prog-json)
@@ -149,7 +149,7 @@
 (require 'music-config)
 (require 'games-config)
 
-;; ------------------------------ Modules In Test ------------------------------
+;; ------------------------------- Misc Modules --------------------------------
 
 (require 'lorem-optimum) ;; best fake latin text generator ever
 (require 'jumper)  ;; navigation help for large projects/lotsa buffers
diff --git a/todo.org b/todo.org
index 7ad41b7b..5e6fd0f3 100644
--- a/todo.org
+++ b/todo.org
@@ -384,7 +384,7 @@ Verify 2026-05-04:
 - Parsed the spec and =todo.org= with =org-element=.
 - Committed the tracked spec as =0528475=.
 
-**** TODO [#B] Classify modules by role and startup requirement :refactor:
+**** DOING [#B] Classify modules by role and startup requirement :refactor:
 
 Create a simple inventory, probably in =docs/design/= or an org note linked
 from this task:
@@ -486,6 +486,12 @@ Expected outcome:
 - Add a note to the local repository docs so future package failures do not
   lead to permanent insecure defaults.
 
+** TODO [#C] latex-config WIP state :refactor:
+The =init.el= require for =latex-config= carried a bare "WIP need to fix" comment with no detail on what was broken. Retired that comment while classifying foundation modules; the underlying state still needs investigation. Read =modules/latex-config.el=, determine what's incomplete, and either finish it or scope a real task.
+
+** TODO [#C] Decide prog-shell config home :refactor:
+The =init.el= require for =prog-shell= carried a "combine elsewhere" comment. Retired it during module classification. Decide whether shell-script editing config should fold into =prog-general= or stay its own module, then act or close.
+
 ** TODO [#B] Rework dev F-keys: compile+run (F4), test (F6), coverage (F7) :feature:
 :PROPERTIES:
 :LAST_REVIEWED: 2026-05-22
-- 
cgit v1.2.3