Сообщение Re[3]: Переписывание старого дерьмокода от 20.01.2016 16:24
Изменено 20.01.2016 16:24 vsb
Здравствуйте, IncremenTop, Вы писали:
vsb>>Комментарии лучше не писать. Это первейший признак плохого кода. Бывают исключения, но редко. Хочешь написать комментарий — вынеси код в функцию с названим, отражающим то, что ты хотел написать в комментарии.
IT>Уже не первый раз встречаю подобное заблуждение. Название даже функции в 20 строчек порой не отображает то, что она делает, а мне именно это и нужно.
20 строчек это уже практически предел размера функции. Уже стоит задуматься о декомпозиции.
IT>И даже если код написан идеально — для разработчика это является потерей времени читать чужой код, когда все нужная для него информация должна быть в комментарии
Потерей времени будет полагаться на комментарий, в котором написано одно, а в коде другое.
IT> еще лучше — писать комментарии на языке, на котором думает команда.
И все будущие команды, которые будут иметь дело с этим кодом. Этот язык — английский.
vsb>>Комментарии лучше не писать. Это первейший признак плохого кода. Бывают исключения, но редко. Хочешь написать комментарий — вынеси код в функцию с названим, отражающим то, что ты хотел написать в комментарии.
IT>Уже не первый раз встречаю подобное заблуждение. Название даже функции в 20 строчек порой не отображает то, что она делает, а мне именно это и нужно.
20 строчек это уже практически предел размера функции. Уже стоит задуматься о декомпозиции.
IT>И даже если код написан идеально — для разработчика это является потерей времени читать чужой код, когда все нужная для него информация должна быть в комментарии
Потерей времени будет полагаться на комментарий, в котором написано одно, а в коде другое.
IT> еще лучше — писать комментарии на языке, на котором думает команда.
И все будущие команды, которые будут иметь дело с этим кодом. Этот язык — английский.
Re[3]: Переписывание старого дерьмокода
Здравствуйте, IncremenTop, Вы писали:
vsb>>Комментарии лучше не писать. Это первейший признак плохого кода. Бывают исключения, но редко. Хочешь написать комментарий — вынеси код в функцию с названим, отражающим то, что ты хотел написать в комментарии.
IT>Уже не первый раз встречаю подобное заблуждение. Название даже функции в 20 строчек порой не отображает то, что она делает, а мне именно это и нужно.
20 строчек это уже практически предел размера функции. Уже стоит задуматься о декомпозиции. А уж если название функции не отражает то, что она делает — то и задумываться не нужно.
IT>И даже если код написан идеально — для разработчика это является потерей времени читать чужой код, когда все нужная для него информация должна быть в комментарии
Потерей времени будет полагаться на комментарий, в котором написано одно, а в коде другое.
IT> еще лучше — писать комментарии на языке, на котором думает команда.
И все будущие команды, которые будут иметь дело с этим кодом. Этот язык — английский.
vsb>>Комментарии лучше не писать. Это первейший признак плохого кода. Бывают исключения, но редко. Хочешь написать комментарий — вынеси код в функцию с названим, отражающим то, что ты хотел написать в комментарии.
IT>Уже не первый раз встречаю подобное заблуждение. Название даже функции в 20 строчек порой не отображает то, что она делает, а мне именно это и нужно.
20 строчек это уже практически предел размера функции. Уже стоит задуматься о декомпозиции. А уж если название функции не отражает то, что она делает — то и задумываться не нужно.
IT>И даже если код написан идеально — для разработчика это является потерей времени читать чужой код, когда все нужная для него информация должна быть в комментарии
Потерей времени будет полагаться на комментарий, в котором написано одно, а в коде другое.
IT> еще лучше — писать комментарии на языке, на котором думает команда.
И все будущие команды, которые будут иметь дело с этим кодом. Этот язык — английский.