# Using LLMs to Evaluate Code Interpretability Instead of Maintaining Comments

DevFeed: [Using LLMs to Evaluate Code Interpretability Instead of Maintaining Comments](<https://devfeed.tech/articles/comments-considered-harmful-in-the-age-of-llms-35601.md>)

Original publisher: [Read original article](<https://www.yegor256.com/2026/01/11/no-documentation-comments.html>)

Author: Yegor Bugayenko (yegor256@gmail.com)

Published: 2026-01-10T21:00:00Z

Content type: opinion

Language: en

Sources: [Yegor Bugayenko](<https://devfeed.tech/sources/yegor-bugayenko.md>)

Topics: [Large Language Model](<https://devfeed.tech/topics/llm.md>), [code comments](<https://devfeed.tech/topics/code-comments.md>), [Documentation](<https://devfeed.tech/topics/documentation.md>), [Software Engineering](<https://devfeed.tech/topics/software-engineering.md>), [trust](<https://devfeed.tech/topics/trust.md>)

Tags: [code-comments](<https://devfeed.tech/tags/code-comments.md>), [code-documentation](<https://devfeed.tech/tags/code-documentation.md>), [code-interpretability](<https://devfeed.tech/tags/code-interpretability.md>), [documentation](<https://devfeed.tech/tags/documentation.md>), [llm-code-analysis](<https://devfeed.tech/tags/llm-code-analysis.md>), [llms](<https://devfeed.tech/tags/llms.md>), [quality](<https://devfeed.tech/tags/quality.md>), [self-documenting-code](<https://devfeed.tech/tags/self-documenting-code.md>), [software-engineering](<https://devfeed.tech/tags/software-engineering.md>)

## AI overview

The article argues that manually maintained code comments can become unclear or outdated. It proposes using LLMs to explain code on demand and introducing a Code Interpretability Score that can fail the build when code is too difficult for the model to explain.

## Source excerpt

Instead of writing code comments that decay and mislead, let LLMs generate documentation on-demand and fail the build when code is too obscure for them to explain.