Лет десять назад нашу контору должна была посетить какая-то комиссия. К этому событию от нас потребовали инструкции на техническое обслуживание и регламентные работы с некоторыми измерительными комплексами. Производитель комплексов один, но модели абсолютно разные. Инструкцию к старой модели поручили писать моему коллеге, многоопытному человеку, успевшему поработать каким-то начальником в почтовом ящике, а про новый прибор поручили писать мне, так как он только появился на тот момент и, на тот момент, вдумчиво пощупать его из всей нашей конторы довелось только мне.
Я продумывал каждое предложение, чтобы получилось максимально просто и понятно. Снабдил инструкцию скриншотами и фотографиями. У меня получилось 3-4 листа А4. (На самом деле, описываемые работы достаточно просты).
Написав инструкцию, я проверил ее на сестре (она музыкант, к технике никакого отношения не имеет). Объяснил ей значение некоторых специфических терминов. Она, в целом, все поняла.
Отношу к начальнику. Он - «так не пойдёт. Надо переделать. Смотри, как твой старший товарищ написал.» И даёт мне многостраничный документ.
Я впервые испытал нечто подобное: я читал инструкцию на прибор, который весьма неплохо знаю (значительно шире, чем простое техническое обслуживание), и ничего не мог понять. Гигантские предложения на четверть страницы, переполненные сложными терминами.
Я поинтересовался: зачем писать инструкцию, по которой невозможно работать? Мне ответили, мол, инструкцию эту будут читать не сотрудники, а члены комиссии. А они ничего понять не должны, кроме того, что мы тут очень сложными делами занимаемся.
В общем, взяв за основу инструкцию коллеги, я по образу и подобию переписал свою. Удалил все скрины и фотографии. Заменил все понятные слова на максимально заумные синонимы. Ну и налил воды.
А нормальные инструкции я несколько раз ещё писал. По просьбе коллег, не для комиссий. С картинками, схемками и стрелочками.