Хаскельное

[metaclass]

http://vit-r.livejournal.com/679524.html?thread=3691364#t3691364
решили на прошлой работе трое таки попробовать Хаскель, для неспешной задачи. генерация DDL, DML c скриптами SQL. Бились, бились, - но сделали, и был восторг! Потом, затянула обычная работа, через месяцок нужно было добавить кое-чего... и никто из троих не смог понять как оно работает, и как же добавить.

Звучит похоже на правду. Хотя у меня и F# и Clojure в подобных задачах живут и развиваются без проблем.

Comments

[rdia.livejournal.com]

> и там будут описаны правила комментирования.

doxygen не подходит? Или вы хотите что-то серьёзнее?

[vit-r.livejournal.com]

Ну а в чём смысл doxygen? Кто результат читает?

[rdia.livejournal.com]

А зачем его прогонять? Достаточно того, что есть формат описания функций, параметров.

И, кстати, что вы используете вместо него?

[vit-r.livejournal.com]

Я использую то, что использует клиеннт. Как правило, вся документация пришется нормально, руками.

[rdia.livejournal.com]

Прошу прощения, я запамятовал, что вы - варяг.

Так doxygen - это тоже руками. Т.е. как вы и хотели - формат комментов к каждой функции. Всё очень чётко - вот описание функции, вот параметры, вот комментарии. Местами, может быть, чересчур многословно, скажем \param я бы убрал, заменив на какой-нибудь символ вроде #.

А сам по себе инструмент doxygen прогонять абсолютно не обязательно, если нет желания иметь ворох html файлов.

[berezovsky.livejournal.com]

Что такое варяг? Который наш гордый, врагу не сдаётся или что?

[rdia.livejournal.com]

Варяг, это тот, кто, как Рюрик, пришёл порулить ненадолго. :-)

[berezovsky.livejournal.com]

А в фильме "Рюрик. Потерянная быль" говорят, что нам врут про Рюрика. :-(

[vit-r.livejournal.com]

Ладно, мне сегодня влом говорить про уровни.

На прошлой неделе видел результат из этого замечательного doxygen. Три четверти параграфов содержали одно слово "None". Не надо путать бюрократию с организацией.