Документирование кода (щас меня будут бить ногами :-)

← →
VMcL © (2004-08-26 17:01) [0]

Подскажите тулзы для (само)документирования кода VB.NET в среде VS.NET 2002 (Framework 1.0).

Входной формат: комментарии в исходном VB-коде.
Выходной формат: CHM-файл.

Обязательно: возможность запуска из командной строки или встраивание в солюшн с возможностью билда посредством `devenv /rebuild ...`

← →
Гаврила © (2004-08-26 17:29) [1]

Ты так всех запугал фразой про битье ногами, что все теперь боятся сюда писать :-)

← →
Piter © (2004-08-26 17:31) [2]

так, так, так. Еще один диверсант в наших рядах... черт побери... шпионы везде! Караул, уже даже к мастерам просочились! Где цвет нации? А-а-а... мочи гадов! Только истинные Дельфийцы имеют право на существование...

← →
stone © (2004-08-26 17:32) [3]

> VMcL © (26.08.04 17:01)

Может ДмитрийО специально для тебя новую версию автошемы слепит? :))

← →
Piter © (2004-08-26 17:34) [4]

Гаврила © (26.08.04 17:29) [1]
Ты так всех запугал фразой про битье ногами

какой ногами?! От так легко не отделается!!! Напоить его и не дать опохмелиться! Повторять кадые три дня до полного просветвления!

← →
Piter © (2004-08-26 17:34) [5]

stone © (26.08.04 17:32) [3]
Может ДмитрийО специально для тебя новую версию автошемы слепит? :))

:)))

← →
VMcL © (2004-08-26 17:38) [6]

Посмеялись и хватит :-)
Давайте всё-таки по теме...

← →
Piter © (2004-08-26 17:43) [7]

Слушай, ну у тебя сама тема смешная. Ну как ты себе представляешь самодокумментирования кода, а? По комментариями что ли?

Как ты себе это представляешь?

← →
Anatoly Podgoretsky © (2004-08-26 17:45) [8]

А нормально представляет, такие продукты есть для разных языков программирования.

← →
VMcL © (2004-08-26 17:53) [9]

>>Piter © (26.08.04 17:43) [7]

Набери в Гугле "auto-documenting" - удивишься.

← →
Piter © (2004-08-26 18:07) [10]

Да нет, я знаю, что такие программы есть.

Я также знаю чувство крайней лени что-то описывать :)

Но неужели кто-то ожидает от этих средств результата? Ведь правильно я понимаю - для описания они используют комментарии? Иначе ИИ какой-то получается...

Ну и что на основе комментариев можно сказать?

← →
Гаврила © (2004-08-26 18:09) [11]

Это смотря какие комментарии
я делал такую штуку для delphi - результат получился неплохой

jack128 © (26.08.04 18:16) [12]
Это хелп не для юзеров, а для программистов, которые будут использовать твой код..

да нет, я понял :)
Только для программистов все равно лучшим хелпом будет код, я разве не прав?

Если уж и что-то строить - то типа принципов Автосхемы :)

То есть, выстроить иерархию классов, нарисовать завимости, представить это все на диаграммах... если код грамотный - то такое "пособие" по коду может тоже быть достаточно грамотным.

Piter © (26.08.04 18:25) [13]
Только для программистов все равно лучшим хелпом будет код, я разве не прав?

Это конечно да, но извни меня в каждом методе, который используешь, разбираться - это ж сдохнуть можно..К тому же ,например, компоненты поставяются без исходников..

>Это конечно да, но извни меня в каждом методе, который используешь, разбираться - это ж сдохнуть можно.

Вот именно. Тем более, документирование - это требование заказчика.

Наверху лучше...

Документирование кода (щас меня будут бить ногами :-) Найти похожие ветки