René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add prek hook to forbid double backticks in docstrings","articleBody":"## Problem\n\nAgents (and developers) sometimes write Python docstrings using RST double-backtick markup (e.g. ``install_requires``) when single backticks should be used instead. This was caught in code review on PR #1795.\n\nDouble backticks are RST-style code spans, but this project does not use RST-rendered docstrings. Single backticks are preferred for inline code references in docstrings.\n\n## Solution\n\nAdd a bespoke prek hook that scans Python files and fails if any docstring lines contain ````...```` (double backtick patterns).\n\n- The hook should be a CLI script accepting a list of files\n- It should parse Python files and check only docstring content (not code)\n- Should report file/line/column of violations\n- Example pattern to forbid: ````foo````\n\n## Agent Skill Update\n\nUpdate the relevant agent skills (e.g. `usethis-python-code`) to explicitly note: do NOT use double backticks in docstrings. Use single backticks for inline code references.","author":{"url":"https://github.com/nathanjmcdougall","@type":"Person","name":"nathanjmcdougall"},"datePublished":"2026-04-06T18:53:29.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1822/usethis-python/issues/1822"}