Отправлено Oldring 03 июля 2003 г. 13:15 В ответ на: А как Вы сами оформляете проектную документацию программ, которые не выходят за пределы фирмы? отправлено Алексей ВМ 03 июля 2003 г. 13:01

Могу сказать про проекты на плюсах.

В двух словах, форма не важна, но нужно документировать принимаемые ключевые решения. То есть требования и архитектуру системы. Здесь, скорее, необходимая документация определяется применяемой методологией проектирования. От программиста требуется писать самодокументируемый код. То есть в соответствии со стилем, принятым в команде. Как правило, код на плюсах, сопровожденный необходимым минимумом комментариев, не требует дополнительной документации на уровне реализаций классов.

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