https://nosemicolons.com/tags/code-readability/Recent content in Code Readability on No SemicolonsHugoen-usThu, 16 Apr 2026 09:11:00 +0000https://nosemicolons.com/posts/ai-code-comment-anti-pattern-making-codebase-worse/Thu, 16 Apr 2026 09:11:00 +0000https://nosemicolons.com/posts/ai-code-comment-anti-pattern-making-codebase-worse/<p>Have you ever opened a file and found comments like <code>// This function calculates the total</code> right above a function called <code>calculateTotal()</code>? If you&rsquo;re using AI coding assistants regularly, you&rsquo;ve probably seen this more than you&rsquo;d like to admit.</p> <p>I&rsquo;ve been wrestling with this problem in my own projects lately. AI tools are incredible at generating code, but their default approach to comments often creates more noise than signal. After spending way too much time cleaning up AI-generated documentation, I&rsquo;ve learned some hard lessons about when to keep, modify, or completely skip the comments our AI companions want to add.</p>