Вячеслав, вы впадаете в крайности.
Сравнение со схемами некорректно - в железе нужно ковыряться, чаще чем в ПО. Кроме того схемы нужно больше монтажникам, чем заказчику.
Раз нужно документировать все и вся, то почему вы не делаете бумажную версию программы с комментариями?