The OpenNET Project / Index page

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



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

Оглавление

Доступен консольный файловый менеджер nnn 4.0, opennews (??), 17-Апр-21, (0) [смотреть все]

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


52. "Доступен консольный файловый менеджер nnn 4.0"  –1 +/
Сообщение от user90 (?), 17-Апр-21, 16:09 
> В этой лапше хрен разберешься.

Несмотря на комментарии к каждой функции.
Может тебе просто не нужно лезть туда, куда ненужно? ;)

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

65. "Доступен консольный файловый менеджер nnn 4.0"  +7 +/
Сообщение от деанон (?), 17-Апр-21, 18:23 
Хочешь сказать, что поколения программистов херней занимались и просто так старались нивелировать влияние сложности систем на стоимость поддержки? И кстати, комментарии это самый неудачный способ описания кода, так что твой язвительный коммент многое говорит о твоих познаниях в программировании
Ответить | Правка | Наверх | Cообщить модератору

72. "Доступен консольный файловый менеджер nnn 4.0"  +1 +/
Сообщение от Урри (ok), 17-Апр-21, 20:02 
Твои знания давно устарели. Мода на "самодокументирующийся код" была модномолодежный десять лет назад.

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

Поэтому снова вернулись к старой как отходы мамонта схеме "название функции должно говорить, ЧТО она делает; а комментарий - КАК она делает". Ну, у кого мозги были, конечно.

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

73. "Доступен консольный файловый менеджер nnn 4.0"  –4 +/
Сообщение от kissmyass (?), 17-Апр-21, 20:14 
то как она делает, должно быть понятно из кода, и коментарий скорее исключение в особо сложных случаях, притов внутри самой функции

а иначе это КГАМ

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

124. "Доступен консольный файловый менеджер nnn 4.0"  +1 +/
Сообщение от iCat (ok), 18-Апр-21, 08:41 
Очень похоже на рассуждения писателя кода для 1С...
Ответить | Правка | Наверх | Cообщить модератору

128. "Доступен консольный файловый менеджер nnn 4.0"  +1 +/
Сообщение от Аноним (128), 18-Апр-21, 10:37 
Дай угадаю - ты ничего существенно сложнее хелловорлд не писал?
Ответить | Правка | К родителю #73 | Наверх | Cообщить модератору

135. "Доступен консольный файловый менеджер nnn 4.0"  +/
Сообщение от kissmyass (?), 18-Апр-21, 12:16 
> Дай угадаю - ты ничего существенно сложнее хелловорлд не писал?

ну ты не угадал, и что дальше? о чем был твой не очень умный вопрос?

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

78. "Доступен консольный файловый менеджер nnn 4.0"  +/
Сообщение от деанон (?), 17-Апр-21, 20:50 
Ещё один продакшин разработчик
Ответить | Правка | К родителю #72 | Наверх | Cообщить модератору

146. "Доступен консольный файловый менеджер nnn 4.0"  +1 +/
Сообщение от боня (?), 18-Апр-21, 15:28 
> Твои знания давно устарели. Мода на "самодокументирующийся код" была модномолодежный десять лет назад.

Это не мода, это норма. Не надо выдавать желаемое за действительность.

Зачем писать комментарий если можно написать тест?
Если вы написали комментарий, а код вокруг него поменялся, что с ним делать?
Где надо писать комментарии, а где не надо писать комментарии? Как уловить эту тонкую грань?
Что делать если комментарий вроде есть, но он понятен только его автору и не вносит ясности?

Я склоняюсь к тому, что комментарии уместны только для публичных членов библиотек, а для внутреннего кода мы их запрещаем всегда.

И да, на моей практике не было ни одного случая, когда комментарий нельзя было убрать.

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

Комментарии плохой код не исправляют, скорее наоборот, в плохом коде плохие комментарии.

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

149. "Доступен консольный файловый менеджер nnn 4.0"  +7 +/
Сообщение от Kir (??), 18-Апр-21, 20:51 
Значит, это особенность вашей предметной области. У нас есть файлы, где комментарий на сотни строк а кода на 40, потому что по мере роста абстракции интерфейса понять по его описанию зачем он и как использовать становится, не зная досконально систему, трудно. Есть каталоги без единого комментария на сотни килобайт кода- потому что аккуратно написанный код в темах, хорошо отображающихся на функциональный код, не должен требовать комментариев. Есть код, часто-разная математика- где без комментариев со ссылками на страницы с формулами из статей и книг вообще ничего не понятно, и расшифровка неоткомментированного кода нерациональна- это сложнее, чем писать заново, разбираясь по новой.
Так что холивар про комментарии возникает из-за ограниченности опыта спорящих.
Ответить | Правка | Наверх | Cообщить модератору

150. "Доступен консольный файловый менеджер nnn 4.0"  +/
Сообщение от боня (?), 18-Апр-21, 21:45 
Продолжайте в том же духе, потом уходите с проекта, а за вами хоть потоп
Ответить | Правка | Наверх | Cообщить модератору

167. "Доступен консольный файловый менеджер nnn 4.0"  –1 +/
Сообщение от Аноним (-), 21-Апр-21, 06:23 
> Значит, это особенность вашей предметной области.

Да какая у галерной вебмакаки особенность? Скорее общая унылость, что самого прогера, что крапа который он изрыгает.

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

156. "Доступен консольный файловый менеджер nnn 4.0"  +/
Сообщение от kamagan (?), 19-Апр-21, 06:42 
Скорее не «как» (это видно из кода), а «почему именно так» и «зачем». Но только там где это необходимо.
Ответить | Правка | К родителю #72 | Наверх | Cообщить модератору

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

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




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

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