UVova, я неумный,наверное, но готов учиться. Если есть учебники для заказчиков, подскажите, плиз. Кроме Ромелы есть еще два программиста, они сдают работу с исходниками, но критериев оформления исходников у нас пока нет.

Вот с этим я согласен. Только тогда времени на оформление исходников уходит почти столько же, сколько и на разработку. Да еще грамотного заказчика надо найти... :-)))

_________________
Привет! Игорь.

вот блин никто так и не может сказать где взять это дело в Харькове

А вы попросите разработчика программы, внести в нее какие нибудь изменения через 2..3 годв. Вот тогда он и пожалеет, что в свое время не потратил время на оформление... :-)

_________________
Александр
-- НН

054026, зачем так долго ждать? 2-3 месяца достаточно .



Вот тока не надо об этом, ладно? Я уже много подобного слышал в своей конторе, сам таким был, да и щас тоже грешу иногда. Типичная отмазка.

Штатовец, вот чессслово, совнршенно не имел ввиду присутствующих. Прошу прощения.
Я, честно говоря, не думаю, что готов Вас чему-нить научить. Могу лишь предположить, что в Вашем случае вполне хватило бы примерно следующего:
1. Описание функционала основных модулей и алгоритмов.
2. Для каждой функции: краткое описание её функционала, описание её параметров и возвращаемого значения.
3. Описание структур данных (какое поле структуры чего содержит) и глобальных переменных.
Только учитывайте, что создание документации - это тоже работа, за неё тоже платят.

Основной принцип простой: программа, написанная по Вашему заказу и за Ваши деньги НЕ ДОЛЖНА зависеть от одного разработчика. Любой другой программер того же уровня должен в ней ориентироваться относительно легко. А для этого ему необходимы пояснения к коду (и в коде).
Ну, для примера, количество комментариев в коде должно находиться в пределах 5-15 процентов от объёма кода.

_________________
С уважением, Uncle Vova

Вообще-то ЕСПД никто не отменял

ГОСТ 19.201-78 ЕСПД. Техническое задание.Требования к содержанию и оформлению.
ГОСТ 19.401-78 ЕСПД. Текст программы. Требования к содержанию и оформлению.

При всей мути и полной моральной старости ЕСПД там есть здравые мысли.

_________________
Всё написанное мною на этом форуме является оценочным суждением автора в смысле п.9 Постановления Пленума Верховного Суда Российской Федерации от 24.02.2005. :wink:

ilia, послал в личку, можно еще спросить у Дорнье .

UVova, создал новый документ " Требования к ПО для Штат" , все туда скопировал, завтра отдам студентам, пусть курсовую работу делают "Оформление ПО и передача его заказчику" . Судя по всему исходники с комментариями дороже на 15% ? .

Штатовец, Что-то не ясно... Как написать большую программу БЕЗ комментариев?

А как бы они написали хоть какой-нибудь обмен с ЭСУД без описания??? Достать описание Бош МР7.0 не проблема...

_________________
Испытания на прочность, скорость и крысату...

Разговор ни о чем. Коментарии нужны на этапе разработки чтобы проще баги находить. Для другого программера мой код все равно будет труднопонимаем. Я свою программу легко вспомню через полгода, если конечно не на асме писана. А через три года кому эта прога нужна?
Пинать не рекомендуется...
P.S. Опубликовано по просьбе Штатовца(постояльца).