Описание алгоритма для разработчика, Что и как правильно требовать разработчику от алгоритмиста? Опции

[novartis]

Суть вопроса: Что и как правильно требовать разработчику от алгоритмиста?

По работе занимаюсь реализацией ЦОС алгоритмов на ПЛИСах.
Процесс разработки внутри отдела протекает следующим образом.
Имеется сектор алгоритмистов, которые на основе ТЗ на НИР, ОКР придумывают алгоритмы.
Чаще всего они обкатывают эти алгоритмы на моделях в Матлаб.
В результате своей работы они приносят в наш сектор разработчиков-программистов документ под названием "Описание алгоритма ...".
Этот документ обычно выглядит как то так:

Введение:
космические корабли бороздят просторы вселенной...

Входные данные:
А - массив на 1000 элементов (что за элементы, какого типа, какой разрядности?)
K - переменная для цикла (очень полезная информация)
с - скорость света
и т. д.

Основная часть:
переписывают листинг программы на матлабе на русский язык

Выходные данные:
В - массив на 1000 элементов (что за элементы, какого типа, какой разрядности?)


Я понимаю, когда с такими листочками приходят и просят прикинуть, сколько времени будет выполняться этот алгоритм на плисине, влезет ли по ресурсам.
Можно считать это рабочим процессом.
В ходе обсуждений и замечаний удается выяснить многие уточнения и ограничения.

Но в конце концов точно такой же алгоритм даже без тех самых уточнений приносят на подпись.
Начальство умоляет подписать, так как срочно (ну как всегда) требуется хоть чем то отсчитаться.
И все вокруг уверяют, что это только первая версия, предварительная, и потом выйдет настоящий полный алгоритм.
А потом про это все забывают, кроме реализатора, то есть меня.

Что-то много букав написал. Суть вопроса вот в чем.
Нашел я ГОСТ 24.211-82 Требования к содержанию документа "Описание алгоритма".
Пролистал, проникся, зародилась у меня идея, каждый раз, когда приносят мне на ознакомление очередной алгоритм, требовать от его автора соблюдения этого стандарта. Одно смущает, ГОСТ старенький (я не в теме, этот советский гост все еще действителен у нас в современной России?) и относится он к АСУ (лучше бы конечно что-то обобщенное).
Может кто подскажет, что посвежее или потематичнее.

Может так же кто поделится своим опытом взаимодействия с коллегами внутри предприятия.

[fowler]

Самый простой вариант - сделать СТП (стандарт предприятия) - все в ГОСТ описано.
Именно в СТП вы можете описать всю необходимую полноту каждого документа, требуемую структуру, порядок согласования и т.д.
На формальном уровне вы должны использовать порядок согласования документов.
Нормоконтроль должен проверить документы на соответствие требованиям СТП (дабы инженеров не отвлекать).
И далее алгоритм утверждается и принимается в работу лишь после того, как вы поставите свою визу согласования.
Ну а вам надо будет просто занять принципиальную позицию и не согласовывать те алгоритмы, которые вас не удовлетворяют
по качеству. Поставили свою подпись - со всем согласны...

[Maverick]

Самый простой вариант - сделать СТП (стандарт предприятия) - все в ГОСТ описано.
Именно в СТП вы можете описать всю необходимую полноту каждого документа, требуемую структуру, порядок согласования и т.д.
На формальном уровне вы должны использовать порядок согласования документов.
Нормоконтроль должен проверить документы на соответствие требованиям СТП (дабы инженеров не отвлекать).
И далее алгоритм утверждается и принимается в работу лишь после того, как вы поставите свою визу согласования.
Ну а вам надо будет просто занять принципиальную позицию и не согласовывать те алгоритмы, которые вас не удовлетворяют
по качеству. Поставили свою подпись - со всем согласны...

мое мнение это порождает только
- большую бумажную волокиту
- злость с обоих сторон и возможный отказ от взаимопомощи в решении проблем при реализации алгоритма
- также нужно понимать, что формально оформленный алгоритм по СТП и написанный алгоритм максимально понятным языком для разработчика это могут быть совершенно разные алгоритмы (особенно это касается матобработки сигнала в виде множества формул (с производными, рядами и т.д.)), т.е. простые вещи написать сложно и не сразу понятным или чего-то не дописать, например переход от одной формулы к другой формуле...
это все может привести к затягиванию сроков...