Привет всем.

Собственно, сабж. А то тут скачал из любопытства doxygen — внушает (с). Но вот соменния по поводу пользы его, если пишу проект один, т.к. комментарии все-равно пишу. А тут как раз начинаю новый проект и не знаю, делать комментарии для doxygen-а или нет.

Что посоветуете? Заранее спасибо.

Здравствуйте, Jenyay, Вы писали:

J>Привет всем.

J>Собственно, сабж. А то тут скачал из любопытства doxygen — внушает (с). Но вот соменния по поводу пользы его, если пишу проект один, т.к. комментарии все-равно пишу. А тут как раз начинаю новый проект и не знаю, делать комментарии для doxygen-а или нет.

Что значит пишу один? А ты уверен, что никому потом не понадобиться возиться в твоем коде?

Nada, nada!
A to posle trjoh ljet sam pazabudesh, shto segodna pisal i sam njifiga njepoimyosh. I komentarii tozhe nada pisat'.

--
Agris

Здравствуйте, Jenyay, Вы писали:

J>Привет всем.

J>Собственно, сабж. А то тут скачал из любопытства doxygen — внушает (с). Но вот соменния по поводу пользы его, если пишу проект один, т.к. комментарии все-равно пишу. А тут как раз начинаю новый проект и не знаю, делать комментарии для doxygen-а или нет.

J>Что посоветуете? Заранее спасибо.

Здравствуйте, <Аноним>, Вы писали:


А>Nada, nada!
А>A to posle trjoh ljet sam pazabudesh, shto segodna pisal i sam njifiga njepoimyosh. I komentarii tozhe nada pisat'.

Понял, спасибо.

Здравствуйте, Воронков Василий, Вы писали:

ВВ>Что значит пишу один? А ты уверен, что никому потом не понадобиться возиться в твоем коде?

Хм, действительно. Не уверен.

Здравствуйте, Jenyay, Вы писали:

J>Привет всем.

J>Собственно, сабж. А то тут скачал из любопытства doxygen — внушает (с). Но вот соменния по поводу пользы его, если пишу проект один, т.к. комментарии все-равно пишу. А тут как раз начинаю новый проект и не знаю, делать комментарии для doxygen-а или нет.

J>Что посоветуете? Заранее спасибо.

Реальная история. Пишу я тут прогу на перл. Написал. Поработал с ней.
Через 2 месяца вернулся к ней и забыл даже что и где она делает.
Документация — одна из важнейших вещей в разработке, даже если пишеш один.
И чем ее больше, тем лучше.

Здравствуйте, Dummy, Вы писали:

D>Реальная история. Пишу я тут прогу на перл. Написал. Поработал с ней.
D>Через 2 месяца вернулся к ней и забыл даже что и где она делает.
D>Документация — одна из важнейших вещей в разработке, даже если пишеш один.
D>И чем ее больше, тем лучше.

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

J>А то тут скачал из любопытства doxygen — внушает (с). Но вот соменния

J>Что посоветуете? Заранее спасибо.

Здравый смысл, дорогой Ватсон, здравый смысл.

Всего-то лишь проблема: пиши комментарии тогда, когда могут быть неясности. А если нет времени — забей.