Документация на "прошивку" ПЛИС - что, как? Опции

[Koluchiy]

Здравствуйте.

Пристал начальник на предмет оформления документации на находящуюся в разработке прошивку для ПЛИС Xilinx.
В качестве образца дается нечто странное.

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

Есть ли на это какие-то ГОСТы, IEEEEEE, или прочие стандарты?

В проекте есть 1 штука ПЛИС Xilinx Spartan3, в ней система с Microblaze (+ программа на С) и кучка логики, написанной на Verilog.

Всем заранее спасибо .

[x736C]

Oldring, с заказчиком — понятно. Как быть с частным случаем — работодателем?
Если: оформлен по классическому ТД, есть должностная инструкция. Существуют требования, обязанности и ответственность. Ну и оклад, разумеется. Дополнительных денег будут стоить «человекочасы» оформления соответствующей КД. И всё.

Разработчики не сильно любят тратить время на документацию. Дело даже не в деньгах и потери ориентации продукта труда на себя любимого. Работа для большинства неинтересная. Зачастую нет навыков делать это быстро, по максимуму автоматизируя процесс. Наблюдение начинал с себя, но собой не ограничивался.

[Oldring]

Oldring, с заказчиком — понятно. Как быть с частным случаем — работодателем?

Чем работодатель принципиально отличается от заказчика? Только лишь долговременностью сотрудничества, меньшими рисками и меньшей прибылью в случае успеха.

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

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

Неужели я буду вынужден вот так просто отдать все это, не получив от этого процент?

Именно. Под сорцами понимается всё, что нужно для разработки. Передадите, так как за сорцы и технологию разработки заказчик заплатит вашему работодателю дополнительные денюжку. Из которой вам также выплатят зряплату.