LINUX.ORG.RU

История изменений

Исправление merhalak, (текущая версия) :

Всегда пишу комментарии для публичных методов (как Java-разработчик). Иногда пишу для непубличных, если сам возвращаюсь и долго не могу вспомнить, почему именно к такому решению я пришёл когда-то.

У нас в компании официально документацию пишем на все публичные (отсутствие как ошибка, ловится SonarQube и maven-checkstyle), но в действительности в коде часто можно увидеть NOSONAR.

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

Исходная версия Deleted, :

Всегда пишу комментарии для публичных методов (как Java-разработчик). Иногда пишу для непубличных, если сам возвращаюсь и долго не могу вспомнить, почему именно к такому решению я пришёл когда-то.

У нас в компании официально документацию пишем на все публичные (отсутствие как ошибка, ловится SonarQube и maven-checkstyle), но в действительности в коде часто можно увидеть NOSONAR.

Людям просто пофигу на взаимодействие в работе: им проще подойти и потыкать, нежели написать нормальный комментарий.