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

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

Думаю, проверю разводку. Открываю интернет -- а там два провода из пяти подключены иначе. Меняю их местами -- и всё начинает работать. То есть, я сам неправильно записал разводку.