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