Все статьи с тегом « Комментарии »

Комментирование кода средствами VCS 22.11.2017

У классического комментирования есть как сторонники, так и ярые противники. Комментированием кода стредствами VCS может пользоваться кто угодно, независимо от его религиозных взглядов на качество кода и его самодокументирование.

Читать дальше

Комментарии в коде. За и почему не против 28.05.2017

По поводу комментариев в коде существуют две точки зрения. Первая говорит, что нужно комментировать как минимум сложные и запутанные места. Вторая — комментарии излишни, комментарии врут, запутанный код нужно переписать так, чтобы он сам говорил за себя. Да, действительно, хороший код не нуждается в комментариях. К сожалению, код действительно хорошим бывает не всегда. С какими проблемы могут помешать нам написать хороший код?

Читать дальше