---
title: "Комментарии"
type: "code-smell"
slug: "comments"
url: "http://localhost:3000/ru/smells/comments.md"
category: "Замусориватели"
description: "Метод содержит множество поясняющих комментариев."
---
# Комментарии

> Метод содержит множество поясняющих комментариев.

## Signs and Symptoms

Метод содержит множество поясняющих комментариев.

## Reasons for the Problem

Зачастую комментарии создаются с хорошими намерениями, когда автор и сам понимает, что его код недостаточно очевиден и понятен. В таких случаях комментарии играют роль «дезодоранта», т.е. пытаются заглушить «дурной запах» недостаточно проработанного кода.

> Самый лучший комментарий — это хорошее название метода или класса.

Если вы чувствуете, что фрагмент кода будет непонятным без комментария, попробуйте изменить структуру кода так, чтобы любые комментарии стали излишними.

## Payoff

* Код становится более очевидным и понятным.
## Relations

**Treated by**

- [Извлечение переменной](/ru/extract-variable.md)
- [Извлечение метода](/ru/extract-method.md)
- [Переименование метода](/ru/rename-method.md)
- [Введение проверки утверждения](/ru/introduce-assertion.md)