Писал инструкцию к программе для клиентов. Клиенты -- не специалисты ИТ (и вообще не технические ребята). Инструкцию написал в двух частях -- первая про пользовательский интерфейс, а вторая -- про механику работы программы (её нужно знать, чтобы можно было с ней работать). И... получилась неравномерность.
Первая часть -- разжёвана до "нажмите левой кнопкой мыши". А вторая написана как для специалиста.
И вот непонятно, что с этим делать -- то ли об'яснить клиентам всю теорию, сопутствующую второй части, на пальцах, то ли приложить учебник, то ли переписать его необходимые части в инструкцию. А может попытаться ещё больше упростить? Но тогда можно потерять суть...
Не хватает умения об'яснять просто сложные вещи!