diper (27.10.2008 17:47, просмотров: 152) ответил Alex B. на ну тады ой. Если бы на С/С++ - то юзать доксиген и не парится. Все равно, конечно, осталась бы проблема лени и похуизма, но как я понял, за аксиому берем что все молодцы. Но все равно согласен с she, в идеальный порядок все привести не удастся =)-
- да-да, я тоже так думал. Вы путаете комментирование и документирование. Если у вас документация никак не связана с исходниками, то держать ее в актуальном состоянии это ацкий труд, проще будет совсем на это болт забить. Alex B.(543 знак., 27.10.2008 17:58)
- ... если модуль сложный, то описание его работы расписано в шапке. Тоже касается функции. Размеры не смущают. Держится в более менее актуальном состоянии. Прелипил шапку одного модуля, текст не важен, главное количество :) diper(27.10.2008 18:10)
- есчо раз - вы говорите про комментирование исходников. Я про документирование - т.е. про отдельный от исходников документ, который им [теоретически] соответствует. Alex B.(588 знак., 27.10.2008 18:19)
- Усе понял. У нас как то не сложилось написание отдельных документов. Обычно на проект (если это одна функционально законченная железка) разработчик для себя составляет один документ в котором расписаны неокторые ньюансы, которые в исходник запихать diper(381 знак., 27.10.2008 18:31)
- во-во. "Когда уходит разработчик" - это один из вариантов, когда нужна документация... - Alex B.(27.10.2008 18:37)
- Дык вот и вопрос - какая документация? - Shura(28.10.2008 10:52)
- Да никакая ;) AlexandrY(325 знак., 28.10.2008 20:43)
- БДСМом увлекаетесь? :) - diper(28.10.2008 21:53)
- Да никакая ;) AlexandrY(325 знак., 28.10.2008 20:43)
- Дык вот и вопрос - какая документация? - Shura(28.10.2008 10:52)
- во-во. "Когда уходит разработчик" - это один из вариантов, когда нужна документация... - Alex B.(27.10.2008 18:37)
- Усе понял. У нас как то не сложилось написание отдельных документов. Обычно на проект (если это одна функционально законченная железка) разработчик для себя составляет один документ в котором расписаны неокторые ньюансы, которые в исходник запихать diper(381 знак., 27.10.2008 18:31)
- есчо раз - вы говорите про комментирование исходников. Я про документирование - т.е. про отдельный от исходников документ, который им [теоретически] соответствует. Alex B.(588 знак., 27.10.2008 18:19)
- ... если модуль сложный, то описание его работы расписано в шапке. Тоже касается функции. Размеры не смущают. Держится в более менее актуальном состоянии. Прелипил шапку одного модуля, текст не важен, главное количество :) diper(27.10.2008 18:10)
- да-да, я тоже так думал. Вы путаете комментирование и документирование. Если у вас документация никак не связана с исходниками, то держать ее в актуальном состоянии это ацкий труд, проще будет совсем на это болт забить. Alex B.(543 знак., 27.10.2008 17:58)