|
|
Регистрация Восстановить пароль |
Регистрация | Задать вопрос |
Заплачу за решение |
Новые сообщения |
Сообщения за день |
Расширенный поиск |
Правила |
Всё прочитано |
|
|
Опции темы | Поиск в этой теме |
03.01.2012, 01:07 | #21 |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
код который практически не нуждается в комментариях.
(хорошие имена функций/классов/переменных/аргументов, не громоздкий код(строки не должны быть огромны и перегружены смыслом) Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
03.01.2012, 01:28 | #22 |
Interdicted
Участник клуба
Регистрация: 25.11.2010
Сообщений: 1,194
|
Элементарное документирования, имхо, нужно. Особенно когда количество строк будет больше за несколько тысяч.
Love writing code and I am really passionate about it
|
03.01.2012, 01:35 | #23 |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
но при хорошем коде отнюдь не везде.
например LoadFromFile(string) не сильно нуждется в документации. но может быть нужно разьяснение результатов(например -1 для CreateFile обязательно) или же насчет исключений. Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
03.01.2012, 07:56 | #24 | |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
|
03.01.2012, 10:47 | #25 | ||||
Форумчанин
Регистрация: 10.09.2009
Сообщений: 352
|
Цитата:
Цитата:
Цитата:
Предварять имя плохо, т.к. помня имя вы можете не вспомнить префикс, тогда IDE вам ничем не поможет - по Ctrl+Space имя выдаётся, если вы набрали его начало, но не середину (во всех IDE, в которых я работал) Цитата:
Поддерживаю, отличная книга. Автор рассмотрел практически все аспекты программирования, ведущие к ошибкам, и показал решения даже на языках, которые к подобным ошибкам предрасположены Последний раз редактировалось anyx; 03.01.2012 в 11:57. |
||||
03.01.2012, 12:17 | #26 | |||
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
Цитата:
Цитата:
и про самодокументируемый. Цитата:
все зависит от того как организовать код. если повторяющиеся блоки вынести в функции, то можно сделать так что код можно просто читать и без комментов. Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
|||
03.01.2012, 12:58 | #27 | |
Старожил
Регистрация: 12.01.2011
Сообщений: 19,500
|
Цитата:
Пример: http://habrahabr.ru/tag/табуляция/ (по тегам еще штук 10 тем), http://stackoverflow.com/search?q=ta...&submit=search
Ушел с форума, https://www.programmersforum.rocks, alex.pantec@gmail.com, https://github.com/AlexP11223
ЛС отключены Аларом. |
|
03.01.2012, 13:16 | #28 | |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
|
03.01.2012, 13:27 | #29 | ||
Eclipse Foundation
Старожил
Регистрация: 19.09.2007
Сообщений: 2,604
|
Цитата:
Цитата:
А уж про комментирование каждой строки так это вообще глупости. Сразу выдает студенческий уровень знаний. А все потому что нормальный программист понимает что такое if(...), else, i++ и иже с ними. По сабжу - использую JavaDoc, jsDoc, YUIDoc. |
||
03.01.2012, 13:31 | #30 | |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Вы не поняли сути - описывается не i++. Описывается алгоритм.
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
|
|
Похожие темы | ||||
Тема | Автор | Раздел | Ответов | Последнее сообщение |
Правила написания кода на 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 |