The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



Вариант для распечатки  
Пред. тема | След. тема 
Форум Разговоры, обсуждение новостей
Режим отображения отдельной подветви беседы [ Отслеживать ]

Оглавление

Google опубликовал утилиту для преобразования GIF в анимиров..., opennews (??), 14-Июн-18, (0) [смотреть все]

Сообщения [Сортировка по времени | RSS]


20. "Google опубликовал утилиту для преобразования GIF в анимиров..."  –2 +/
Сообщение от Аноним (-), 15-Июн-18, 00:14 
> Правда, у нас в шараге за отсутствие каментов надбавок бы лишили. И печенек тоже.

Ну, у вас в шараге видимо принято писать код таким образом, чтобы без комментов его понять было невозможно. Самая лучшая документация - это написанный на формальном языке исходный код, а комментарии, будучи вписываемыми в свободной форме, частенько врут и, сами того не желая, могут вводить в заблуждение.

Ответить | Правка | Наверх | Cообщить модератору

21. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от Аноним (-), 15-Июн-18, 00:36 
Формальный язык это индусы?
Ответить | Правка | Наверх | Cообщить модератору

76. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от Аноним (-), 18-Июн-18, 09:53 
Санскрит!
Ответить | Правка | Наверх | Cообщить модератору

40. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +2 +/
Сообщение от KonstantinB (ok), 15-Июн-18, 09:10 
На тему комментариев мне вспоминается код где-то 12-летней давности, который в той компании, где он был написан ее сотнудником, стал каноничным примером "как не надо делать". Выглядело это так:

$db->beginTransaction(); // начинаем транзакцию

...далее следует простыня кода строк на 200 со стремящейся к бесконечности цикломатической сложностью без единого комментария...

$db->commit(); // завершаем транзакцию

А вообще, да, у меня правило - если хочется написать комментарий, то надо переписать код так, чтобы он был не нужен. И только в редких случаях (например, оптимизация), когда переписать без потерь нельзя, пишу комментарии. (Кстати, в случае оптимизации полезно рядом оставить окруженный if (0) неоптимизированный читабельный вариант алгоритма).

Ответить | Правка | К родителю #20 | Наверх | Cообщить модератору

46. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от Аноним (-), 15-Июн-18, 09:33 
Во-во. Еще, к примеру, код, который ты правишь прямо сейчас, может упоминаться в комментах в абсолютно другом файле: наличие обильных комментариев означает, что тебе нужно не просто править код, но и искать по всему проекту все места, где этот код в комментах хоть как-то упоминается. Изменяешь интерфейс - иди ищи-свищи все комменты, где на него ссылаются. Удалил метод? - поищи, вдруг кто-то в комментах рекомендует его использовать. Самый простой и яркий пример из моей практики: в теле одного метода был вставлен коммент, где упоминался "предыдущий метод", типа:

first () {
}
second () {
  // Зачем нужен этот метод, когда есть предыдущий?
}

Далее другим программистом был вставлен третий метод, аккурат между первым и вторым; таким образом, коммент стал вводить в заблуждение. ИЧСХ, никто себе такой цели не ставил - кого-то обмануть, просто так случилось.

Сопровождение комментариев - работа, которая столь же важна, сколь и работа по сопровождению кода, но на нее никто и никогда специального времени не выделяет, поэтому их лучше не писать вовсе. (А вообще, если по-хорошему, документирование проекта - это работа отдельного сотрудника, технического писателя.)

Ответить | Правка | Наверх | Cообщить модератору

48. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +2 +/
Сообщение от KonstantinB (ok), 15-Июн-18, 10:30 
Вообще, подобные проблемы по большей части решаются на code review.

Я, даже если делаю проект один, пользуюсь git flow и мержу только через пулл-реквесты. Даже после небольшого перерыва на чашечку кофе смотришь на собственный код, показанный в виде наборов изменений, несколько более свежим взглядом.

Ответить | Правка | Наверх | Cообщить модератору

49. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от NuclearWar (?), 15-Июн-18, 10:41 
> А вообще, да, у меня правило - если хочется написать комментарий, то надо переписать код так, чтобы он был не нужен. И только в редких случаях (например, оптимизация), когда переписать без потерь нельзя, пишу комментарии.

COBOL переизобретаешь?

Ответить | Правка | К родителю #40 | Наверх | Cообщить модератору

66. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от anonimm (?), 16-Июн-18, 17:10 
> А вообще, да, у меня правило - если хочется написать комментарий,
> то надо переписать код так, чтобы он был не нужен.
> И только в редких случаях...

Только для софта уровня студенческой лабораторной работы.

> $db->beginTransaction();
> $db->commit();

php... Тогда всё понятно.

Ответить | Правка | К родителю #40 | Наверх | Cообщить модератору

69. "Google опубликовал утилиту для преобразования GIF в анимиров..."  +/
Сообщение от НяшМяш (ok), 16-Июн-18, 23:31 
>> $db->beginTransaction();
>> $db->commit();
>
>php... Тогда всё понятно.

Ну, тут уже личинка программиста просматривается - оно про транзакции знает.

Ответить | Правка | Наверх | Cообщить модератору

Архив | Удалить

Рекомендовать для помещения в FAQ | Индекс форумов | Темы | Пред. тема | След. тема




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру