Когда разрабатываешь программу для себя, у неё удивительно понятный интерфейс. Ты знаешь, где настройки, зачем нужна эта кнопка и что делать, если после запуска что-то пошло не так. Потом возникает мысль: пора дать попробовать другим. И тут выясняется, что вместе с приложением хорошо бы передать ещё и часть содержимого собственной головы. Желательно в формате PDF )) Вчера мы с ChatGPT готовили инструкцию пользователя для ИТКонтроля — нашего приложения для учёта оборудования и контроля инфраструктуры. Пока работаешь над функциями, внимание занято конкретными задачами: добавить оборудование, получить показатели, исправить ошибку. Инструкция заставляет посмотреть на всё с другой стороны. Что человек должен сделать сначала? Что ему понадобится для запуска? Как понять, что приложение запустилось нормально? Где искать нужный раздел? А если результат отличается от описанного — что проверять? Для автора ответы очевидны. Он ведь уже несколько раз прошёл этот путь. Иногда с ошибками, переписками и исправлениями до позднего вечера. У нового пользователя такого опыта нет. И приобретать его тем же способом ему совершенно необязательно :) Отдельный вопрос — примеры. Во время разработки удобно опираться на знакомую инфраструктуру. Но в инструкции для других пользователей должны быть нейтральные названия и понятные ситуации. Поэтому документ тоже прошёл свою правку: привычные рабочие примеры заменили на условную компанию. В результате подготовили руководство в PDF и Word. Это ещё не означает, что все вопросы закрыты: насколько инструкция понятна, станет видно, когда по ней попробует пройти другой человек. Но для меня это важный этап. ИТКонтроль постепенно выходит из состояния «я объясню, ты пока нажимай» и готовится к самостоятельному знакомству с пользователем. С AI такая работа особенно интересна. Код можно получить довольно быстро. А потом приходится подробно объяснять, как этим кодом пользоваться. И по дороге замечаешь места, где проще переделать само приложение, чем писать три абзаца пояснений к одной кнопке )) А вы когда в последний раз открывали инструкцию к программе? И что заставило: желание разобраться или уже полное отчаяние?

#ИТКонтроль #РазработкаСИИ #Автоматизация #СистемноеАдминистрирование