Reduce and tighten code comments and docstrings repo-wide (#6095)

Trim and tighten code comments and docstrings across the repository. Comment-only: every changed file verified code-identical to main via AST/token comparison.

scripts/verify_comment_only_diff.py

@@ -57,9 +57,7 @@ def _git_show(rev: str, path: str) -> str:
 
 
 def _strip_docstrings(tree: ast.AST) -> ast.AST:
-    """Remove every string-literal docstring (Module / FunctionDef /
-    AsyncFunctionDef / ClassDef). Empty body becomes ``pass`` so
-    ast.unparse stays valid."""
+    """Remove docstrings; empty bodies become ``pass`` so unparse stays valid."""
     for node in ast.walk(tree):
         if isinstance(
             node,
@@ -87,9 +85,8 @@ def _normalize_py(src: str) -> str:
 
 
 def _strip_shell_comments(s: str) -> str:
-    """Strip pure-comment lines and inline trailing comments from a shell
-    snippet, then collapse runs of blank lines. Heuristic only: leaves a
-    line untouched if it has an odd quote count (open string)."""
+    """Strip shell comments and collapse blank lines. Heuristic: skips lines
+    with an odd quote count (open string)."""
     out = []
     for line in s.splitlines():
         stripped = line.lstrip()
@@ -116,9 +113,7 @@ def _strip_shell_comments(s: str) -> str:
 
 
 def _normalize_yaml_run_strings(obj: Any) -> Any:
-    """Walk the parsed YAML object; for any multi-line string (i.e. a
-    ``run: |`` script body), strip shell comments. Returns a normalised
-    copy."""
+    """Strip shell comments from any multi-line string (``run: |`` body)."""
     if isinstance(obj, dict):
         return {k: _normalize_yaml_run_strings(v) for k, v in obj.items()}
     if isinstance(obj, list):