comments that explain the code, not how it was written

About 340 comments cited the development process: task and plan
numbers, fix waves, rulings, reviewers, and the author in the third
person with a date. None of that exists outside the work itself, so to
a reader it pointed at nothing. Each one now states the engineering
reason it was standing in front of; where a comment was provenance and
nothing else, it is gone.

References to docs/design.md and docs/gui-design.md by section stay:
both ship with the repository. The design documents lose their
amendment diaries - CHANGELOG.md is that record - and the GUI's says
plainly that the window has gone further than the document.

Only comments changed. Every .go file was parsed and its code printed
with comments stripped, before and after: the two hashes are identical
across all 175 files.

1 files changed, 6 insertions, 7 deletions

diff --git a/internal/engine/engine.go b/internal/engine/engine.go
index cc776e6..cde1298 100644
--- a/internal/engine/engine.go
+++ b/internal/engine/engine.go
@@ -1,8 +1,8 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 
 // Package engine is what every krino front end calls: it loads and compiles
-// the configuration, matches files against rules, and (from plan 3) plans
-// and applies actions. It returns data; front ends only render it.
+// the configuration, matches files against rules, and plans and applies
+// actions. It returns data; front ends only render it.
 package engine
 
 import (
@@ -20,7 +20,7 @@ import (
 )
 
 // Engine holds a loaded, compiled configuration: everything a front end
-// needs to check, match and (from plan 3) act.
+// needs to check, match and act.
 type Engine struct {
 	Config   *config.Config
 	Dirs     []*Dir
@@ -98,10 +98,9 @@ func LoadWith(mainFile string, overrides map[string][]byte, names ...string) (*E
 	reported := map[string]bool{}
 	if len(cfg.Dirs) == 0 {
 		// With no directory to compile them for, krino.conf's excludes are
-		// still checked, so a mistake is reported before one is included
-		// (review cli F10).
+		// still checked, so a mistake is reported before one is included.
 		// Compiled with the defaults' case and fold, as a directory without
-		// settings of its own would compile them (triage 28g).
+		// settings of its own would compile them.
 		def := cfg.Main.Defaults.Over(config.Builtin())
 		opt := cond.Options{IgnoreCase: def.Case == config.CaseIgnore, Fold: def.Fold}
 		for _, x := range cfg.Main.Excludes {
@@ -186,7 +185,7 @@ func checkCaptures(file string, r *config.Rule, c *cond.Cond) *config.Diag {
 	for _, a := range r.Actions {
 		if err := plan.CheckTemplate(a.Arg); err != nil {
 			// A placeholder that could never expand is a config error, not a
-			// step skipped at plan time (plan 12).
+			// step skipped at plan time.
 			return &config.Diag{File: file, Pos: a.Pos, Msg: fmt.Sprintf("rule %q: %v", r.Name, err)}
 		}
 		n, err := plan.MaxIndex(a.Arg)