Add comment explaining why private functions without docstrings are omitted

Copilot · nathanjmcdougall · web-flow · commit e242483792e6 · 2026-04-07T07:07:16.000Z
Co-authored-by: nathanjmcdougall &lt;18602289+nathanjmcdougall@users.noreply.github.com&gt;
diff --git a/hooks/export-functions.py b/hooks/export-functions.py
@@ -74,6 +74,8 @@ def main() -> int:
             if first_line is not None:
                 bullets.append(f"- `{func_name}()` (`{module}`) — {first_line}")
             elif not func_name.startswith("_"):
+                # Only track missing docstrings for public functions; private
+                # functions without a docstring are silently omitted from output.
                 missing.append((py_file, func_name))
 
     content = os.linesep.join(bullets) + os.linesep
