Про ошибки в документации

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

Это напомнило мне случай с моим отцом. Кто не знает - он без малого 50 лет работает на танковом заводе и последние много лет - в отделе гарантийного обслуживания.

Поскольку писать отчеты в какой-нибудь пустыне (к примеру в Пакистане) из раскаленного докрасна танка не очень комфортно, все это записывалось на бумажке и потом, по приезду в Украине оформлялось в бюрократические обертки. Ну и я иногда просто помогал набирать эти документы. Один из них запомнился мне :)

На странице 30 на принципиальной схеме устройства ______ ____ в квадрате А6 маркировки "плюс" и "минус" не соответствуют действительности. Вследствие этого, было выполнено неправильное подключения блока Х, что привело к выходу из строя "список оборудования на половину страницы". Для устранения последствий были выполнены следующие работы - "список еще на две страницы". Рекомендация: исправить схему на странице 30

Так что кому нужна та документация :)