С детства люблю составлять инструкции. Возможно, это наследственное, поскольку мой папа тоже всегда любил составлять инструкции. В десять лет я написал инструкцию по использованию авторучки на три страницы. Дальше -- больше. Самым об'ёмным моим трудом является инструкция по прохождению вн-ки Never7 на 80 страниц. И нашёлся даже человек, который её зачем-то прочитал, а потом мы подружились, лол (это был гражданин Пво, его некоторые знают).
По работе мне тоже приходится периодически составлять инструкции. Написал программу -- пишешь инструкцию по эксплуатации. Эти инструкции уже не для развлечения, а по делу. Ими люди пользуются. Некоторые их читают -- и вопросов у них нет. Всё осваивают. Некоторые ничего не понимают -- и приходится дополнительно об'яснять.
Как же определить, хорошая получилась инструкция или нет? Однозначно это не определить, потому что написать то, что поймёт каждый, по-видимому, невозможно. Но есть парочка косвенных признаков:
1) К хорошей инструкции постоянно обращаешься сам. Это означает, что туда включены структурированные справочные сведения, которые нужны, но которые наизусть помнить смысла нет.
2) Когда возвращаешься к хорошей инструкции спустя год -- благодаря ей очень быстро всё вспоминаешь. Это означает, что написано достаточно понятно, чтобы хотя бы сам автор понял, о чём была речь. Особый бонус, когда у тебя возникает вопрос -- и в следующей строчке находишь на него ответ.
3) Когда надо что-то сообщить коллеге/клиенту, достаточно просто отправить ему инструкцию с указанием раздела. Это означает, что инструкция охватывает именно те операции, которые нужны на практике.