20:01 

I'll destroy this tiny Earth. Darth Mochalkin. Truly yours.

Foul thing
¡ʎuunɟ ʇou sı sıɥʇ
Есть такая парадигма программирования, которая утверждает, что излишние комментарии в коде не только не полезны, но и даже наоборот, вредны. Они загромождают код и зачастую склоняют программиста к тому, чтобы писать непонятно и потом это непонятное комментировать. С точки же зрения этой парадигмы писать и структурировать нужно так, чтобы и без комментариев код читался как родной язык.

Условно говоря, строка str.saveToFile(fileName);в комментарии не нуждается, поскольку целиком и полностью описывает сама себя.

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

Ну а пока что, встречая многостраничный метод, являющий собой стену неразбитого текста без комментариев, остается только за голову хвататься. Особенно, когда он называется load_in_base(). Догадайтесь без помощи словаря и такой-то матери, что он делает. Ну конечно же! Он читает большущую запись из БД и заносит ее в специальный объект.

Ай кен спик инглиш, ай лерндт ит фром зе бук! (с)

URL
Комментарии
2017-03-29 в 22:57 

Заболекарь
Мегакрендель: заколебарь, жаболекарь, зомболекарь, лежебокарь
А теперь представь комментарии на этом языке.

2017-03-30 в 01:04 

zHz00
Хихихихи.

Я однажды совершил ошибку. Я написал комментарий на японском языке (латиницей). Потом я переключился на другой проект, а тот стали делать другие люди. И я подумал -- боже, они прочтут коммент, но нифига не поймут!

Что касается понятных имён переменных и прочего. Часто я сталкиваюсь с тем, что есть несколько переменных, которые предназначены для сходных задач. В одном методе. Но задачи всё-таки различные. Имена у переменных получаются тоже похожие, но различные. И вот в этом случае чаще всего имена получаются неговорящими. Либо надо удлинять имя переменной в 5 раз и целиком прописывать разницу, либо надо добавить что-нибудь типа ...Cur (current). Но без Cur тогда какая? Не текущая, что ли? Что она (переменная) делает?

2017-03-30 в 11:42 

8115
В "Совершенном коте" хорошо написано и про комментарии, и про имена переменных.

     

Temporary Internet Flies

главная