René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"hooks: export-functions.py excludes private functions from docs/functions.txt","articleBody":"The `hooks/export-functions.py` script explicitly skips functions whose names start with `_` (line 129: `if node.name.startswith(\"_\"): continue`). This means private helpers such as `_get_current_python_version()` are not included in `docs/functions.txt` (and therefore absent from the Function Reference in AGENTS.md).\\n\\nAgents rely on this reference to discover reusable helpers and avoid reinventing existing logic. If useful private helpers are invisible, agents may duplicate their functionality.\\n\\nDecision needed: should the hook also export private module-level functions (with a visual indicator), or should the AGENTS.md guidance explicitly note that private helpers are excluded?","author":{"url":"https://github.com/nathanjmcdougall","@type":"Person","name":"nathanjmcdougall"},"datePublished":"2026-04-04T02:21:58.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1807/usethis-python/issues/1807"}