?

Log in

November 2016   01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
cartoon

Миф о документации, продолжение

Posted on 2011.06.18 at 23:06

Comments:


Gaperton
gaperton at 2011-06-19 19:57 (UTC) (Link)
Картинки рисовать нет никакого смысла - они извлекаются из кода тулами автоматически, и будут всегда актуальны. Для С++ это отлично делает Rational Rose. Любая class-диаграмма рисуется в минуты, так что глупо на "документирование" этого время тратить.

Общие для подсистемы важные вещи, являющиеся "хинтами" для реверс-инжиниринга, надо писать в хедерах основных классов, которые являются "точкой входа" в подсистему. И далее по цепочке.

Все.
blueher at 2011-06-19 20:21 (UTC) (Link)
Картинки - это далеко не всегда диаграмма классов и им подобные (которые генерируются по коду в любой момент).
Часто нужно "обрисовать" предметную область.
Previous Entry  Next Entry