|
Вопрос документирования разработок зависит от оборотов и стабильности компании. Если компания барахтается на поверхности, думая только о том, чтобы не утонуть - никакого внимания документированию нет. Или когда руководство все время орет "давай-давай", особо не задумываясь о качестве продукта.
Кстати, комментарий "кто" при разработке сложного тиражного продукта смысла не имеет. Ну на кой ляд мне разбросанные в тексте десятки фамилий? Внутри группы разработки идентификация производится другими методами, а конечному пользователю авторы кусков кода ни к чему (они, скорее всего, уже уволились...). Вполне достаточно предназначения. Вот при модификации типовых решений под конкретный проект - там такой подход желателен.
Что касается тех русских программ, с которыми довелось работать, то типовые 1С под 8.0 сейчас - одни из (если не самые лучшие) по документированности. Прямое следствие растущих оборотов компании и тенденции перенимать лучшее у западных разработчиков.
Что есть:
Документация пользователя с примерами выполнения типовых действий.
Документация программиста с примерами использования каждого метода в реальном коде.
Учебные конфигурации на дисках ИТС, опять же с примерами кода и разбором типовых проблем (для русской системы это редкость).
Подробное описание каждого объекта в системе для пользователя (с гиперссылками на описание связанных функций/объектов).
Нормальная документированность кода. Если еще учесть его "русскую" основу - читается очень хорошо.
И по качеству документированности у меня вообще к 1С претензий нет.
Все претензии касаются функционала и багов.
|