|
|
Регистрация Восстановить пароль |
Регистрация | Задать вопрос |
Заплачу за решение |
Новые сообщения |
Сообщения за день |
Расширенный поиск |
Правила |
Всё прочитано |
|
|
Опции темы | Поиск в этой теме |
03.01.2012, 14:27 | #41 | |||
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
не зная типы, и входные параметры тяжело судить о коде.
Код:
Цитата:
но если уж код, нуждается в них, то нужно их писать. я не говорил что комментарии в топку. Цитата:
Цитата:
но просто мне лично тяжело читать смесь транслита и английского. Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. Последний раз редактировалось Пепел Феникса; 03.01.2012 в 14:32. |
|||
03.01.2012, 14:35 | #42 |
Старожил
Регистрация: 30.12.2009
Сообщений: 11,430
|
Я для форматирования использую спец. утилиты. И конечно же стремлюсь форматировать код так же. Поддержу Пепла Феникса в пользу использования минимума комментариев и максимума Человеко-Понятных Имён переменных, методов, функций и т.д. Если не сокращать, давать максимум смысла и коротко изложить, то получается и комментарии не нужны.
Кому нужно, тот разберётся в коде. Нужно знать 3 вещи: 1. Синтаксис 2. Иметь опыт, смекалку и думалку, 2 руки из плеч и голову из шеи. 3. Уметь пользоваться справкой и гуглом. Документация кода - для кого-то капризного. Комментарии - для себя любимого. Документация абязана быть там, где вы что-то новое создали(аля класс). А комментарии.. ну йух с ними =) Кому надо, тот разберётся. Все дело в том, кто пишет код. Последний раз редактировалось Человек_Борща; 03.01.2012 в 14:37. |
03.01.2012, 14:42 | #43 | ||||
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Цитата:
Цитата:
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
||||
03.01.2012, 14:42 | #44 | |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
Цитата:
Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
|
03.01.2012, 14:58 | #45 | |
Eclipse Foundation
Старожил
Регистрация: 19.09.2007
Сообщений: 2,604
|
Цитата:
По мне, так следующий стиль более понятен, нежели комментирование каждой строки Код:
Но даже здесь непросто разобраться, потому что этот класс вырван из контекста проекта. И да - этот код не претендует на звание идеального. Но он неплохо документирован, что облегчает его понимание. P.S. кто не понял - это JavaScript. Последний раз редактировалось MaTBeu; 03.01.2012 в 15:04. |
|
03.01.2012, 15:03 | #46 | ||
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика Последний раз редактировалось Utkin; 03.01.2012 в 15:06. |
||
03.01.2012, 15:06 | #47 | |
Eclipse Foundation
Старожил
Регистрация: 19.09.2007
Сообщений: 2,604
|
Молодец, я даже плюсанул ему за это. Поверьте мне, я видел много плохого кода, так что не стоит тут тыкать носом в плохой код и говорить что он показательный. Вам комментарии на каждой строке не помогли бы даже в таком коде.
Цитата:
Работа в команде не была подчинена внутреннему стандарту. Это была инциатива как моя, так и отдельных разработчиков. Просто в какой-то момент я стал писать такие комментарии и получилось сделать код понятнее, вот и все. Последний раз редактировалось MaTBeu; 03.01.2012 в 15:09. |
|
03.01.2012, 15:08 | #48 | |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
|
03.01.2012, 15:13 | #49 | ||
Eclipse Foundation
Старожил
Регистрация: 19.09.2007
Сообщений: 2,604
|
Цитата:
Цитата:
Плохой код пишут все, независимо от уровня подготовки, но это не значит, что его нужно делать еще хуже. |
||
03.01.2012, 15:15 | #50 | |
Старожил
Регистрация: 30.12.2009
Сообщений: 11,430
|
Цитата:
Не комментировать код, естественно, жестоко даже для себя. Комментировать каждую строку убого. А вот ход работы и состояние чего-то на такой-то момент в такой-то строке кода - уже полезно. Все зависит от размера подпрограммы. Сложные алгоритмы надо комментировать не плотно, но чтобы смысл предыдущего комментария не терялся в следующем комментарии, а развивался строка за строкой. |
|
|
Похожие темы | ||||
Тема | Автор | Раздел | Ответов | Последнее сообщение |
Правила написания кода на Delphi | Virtson | Общие вопросы Delphi | 17 | 06.08.2010 08:59 |
Правила разделов/главные правила | Alex Cones | О форуме и сайтах клуба | 1 | 30.09.2009 17:49 |
Оформления текста | tae1980 | Microsoft Office Excel | 6 | 26.03.2009 18:54 |
Стили оформления кода | Altera | Свободное общение | 2 | 30.08.2008 17:23 |
Проблема оформления | SunKnight | Общие вопросы Delphi | 3 | 25.02.2008 01:11 |