|
|
Регистрация Восстановить пароль |
Регистрация | Задать вопрос |
Заплачу за решение |
Новые сообщения |
Сообщения за день |
Расширенный поиск |
Правила |
Всё прочитано |
|
|
Опции темы | Поиск в этой теме |
03.01.2012, 13:37 | #31 | |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
Цитата:
а в документации уже описывается сам алгоритм. вообще код это реализация алгоритма. Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
|
03.01.2012, 13:39 | #32 | |
Eclipse Foundation
Старожил
Регистрация: 19.09.2007
Сообщений: 2,604
|
Цитата:
Если нужно описать алгоритм, то проще написать к нему документацию (она для этого и создана). Извините, если я вас неправильно понял. |
|
03.01.2012, 13:53 | #33 |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Ну если Вы такие все такие правильные , объясните чем занимается фрагмент данной функции на Дельфи:
Код:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика |
03.01.2012, 13:55 | #34 | |
Great Code Monkey
Форумчанин
Регистрация: 09.08.2007
Сообщений: 533
|
На работе приходится лазить по нескольким гигабайтам кода. И лично мне куда удобнее его читать, когда он написан красиво, понятно и без комментариев, которые его засоряют. Обычно в самом начале нетривиального класса или функции просто ставится ссылка на документацию в вики проекта. А там уже понятным языком описан алгоритм, почему сделано так или иначе, различные нюансы, способы применения, что можно улучшить и прочее...
Проблема рассинхронизации кода с документацией может решаться на уровне ревью кода - код может быть одобрен, но коммит не пропускается, пока не сделан ап документации. PS раньше юзал doxygen, но в последний год он мне разонравился как-то... PPS есть довольно неплохой google c++ style guide, а еще qt coding style Цитата:
Последний раз редактировалось still_alive; 03.01.2012 в 13:57. |
|
03.01.2012, 14:02 | #35 |
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
still_alive, я могу назвать Вас верхом неадекватности. Ибо вопрос стоял не о качестве кода. Что за еврейские подходы к решению задачи? Вы же прошли гигабайты кода и должны знать что подобного хлама всегда больше чем действительно хорошего. Кстати, он работает. Мне ли Вас учить - тут не то что рефакторинга - банальная автозамена в 5 минут улучшит ситуацию. Вопрос в другом как бы.
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика Последний раз редактировалось Utkin; 03.01.2012 в 14:06. |
03.01.2012, 14:02 | #36 | |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
1)совмещение английского и транслита это ужас.
2)разбор синтаксических конструкций, макс размер конструкции 8. Цитата:
отчасти согласен. кстати, еще одна вещь, верная что для Делфи, что для С++. лучше писать обращение к самому себе через this/Self. Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. |
|
03.01.2012, 14:05 | #37 | |
Great Code Monkey
Форумчанин
Регистрация: 09.08.2007
Сообщений: 533
|
Цитата:
|
|
03.01.2012, 14:09 | #38 | |||
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Я собственно такого ответа и ожидал . Нет ни одного четкого ответа по вопросу. Ближе всех был Пепел Феникса (но я для него и закидывал удочку). Зато сколько умных слов . Право я повторюсь - не спешите с выводами.
Цитата:
Цитата:
Цитата:
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика Последний раз редактировалось Utkin; 03.01.2012 в 14:13. |
|||
03.01.2012, 14:12 | #39 |
Старожил
Регистрация: 28.01.2009
Сообщений: 21,000
|
Уткин, а разве код идеален?
Хорошо поставленный вопрос это уже половина ответа. | Каков вопрос, таков ответ.
Программа делает то что написал программист, а не то что он хотел. Функции/утилиты ждут в параметрах то что им надо, а не то что вы хотите. Последний раз редактировалось Пепел Феникса; 03.01.2012 в 14:19. |
03.01.2012, 14:15 | #40 | ||
Старожил
Регистрация: 04.02.2009
Сообщений: 17,351
|
Цитата:
Допустим имеется строка x=x+1 и х = х+1 Какая строка будет распознана, а какая нет? Уточню данная функция возвращает Boolean. Какой будет результат функции для первого, и какой для второго вариантов? Цитата:
а) Это намек на пьяный код. Если бы Вы читали комментарии, то поняли бы и его. б) На придирки по транслитерации и им подобные я уже писал в посте # 35. Зачем его переписывать с нуля? Это очередной Ваш минус. Нормальный человек попытается понять алгоритм - если он верен нужно провести рефакторинг.
Маньяк-самоучка
Utkin появился в результате деления на нуль. Осторожно! Альтернативная логика Последний раз редактировалось Utkin; 03.01.2012 в 14:26. |
||
|
Похожие темы | ||||
Тема | Автор | Раздел | Ответов | Последнее сообщение |
Правила написания кода на 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 |