Рубрика «технический писатель»
Искусственный интеллект в документации: как внедрить бота-документоведа
2024-11-24 в 12:16, admin, рубрики: qa, документация, ИИ, нейросети, техническая документация, технический писатель, чат-бот, Чат-боты, чатбот, чатботы
Почему пользователи не читают документацию или как можно улучшить руководство пользователя
2022-03-04 в 16:33, admin, рубрики: Подготовка технической документации, пользовательская документация, разработка документации, технический писательЧасть первая
Данная статья не предполагает каких-то заумных и крайне неочевидных советов по написанию и проверке технической документации. Многие из перечисленных «советов» многим покажутся очевидными, но из раза в раз, анализируя документацию наших пользователей, мы сталкиваемся с одними и теми же банальными ошибками, которые чаще всего происходят из-за фактора «забыл». Так что данный пост можно расценить как памятку не техническому писателю.
Приятного чтения.
Внешний вид и скриншоты в пользовательской документации. Как надо и не надо делать
2020-10-26 в 7:12, admin, рубрики: Анализ и проектирование систем, Блог компании Блог компании «Актив», документация, технический писатель
Люди читают пользовательскую документацию, когда самостоятельно не могут с чем-то разобраться. Они не делают это для развлечения. И эмоции, которые преобладают в этот момент, далеко не всегда позитивные. Как разработчик пользовательской документации может помочь пользователю? Что ему необходимо учитывать при написании документа?
К чему приложить прикладного лингвиста?
2019-06-07 в 12:03, admin, рубрики: students, Veeam, Карьера в IT-индустрии, магистратура, студенты, технический писатель, учеба, Учебный процесс в IT“Что за дело? Это многих славных путь.”
Н.А. Некрасов
Всем привет!
Меня зовут Карина, и я “совместитель” — совмещаю учёбу в магистратуре и работу технического писателя в Veeam Software. О том, как у меня это вышло, я и хочу рассказать. Заодно кто-то узнает, как можно прийти в эту профессию, и какие я вижу для себя плюсы и минусы в работе во время учебы.
Я работаю в Veeam без году неделю полгода с небольшим, и это были самые насыщенные полгода моей жизни. Я пишу техническую документацию (и учусь её писать) — сейчас я занимаюсь руководством по Veeam ONE Reporter (вот оно) и гайдами по Veeam Availability Console (про нее была статья на Хабре) для конечных пользователей и реселлеров. Еще я из тех, кому сложно парой слов ответить на вопрос «Откуда ты приехала?». Вопрос «Как ты проводишь свободное время?» тоже не из простых.
Взгляд работающего студента, когда ему жалуются на недостаток свободного времени
Читать полностью »
Пользовательская документация: что делает её плохой, и как это исправить
2019-03-14 в 7:59, admin, рубрики: user guide, Блог компании ISPsystem, документация, мануал, технический писатель, Управление продуктом, управление разработкой, Учебный процесс в IT
Документация к софту — это просто набор статей. Но даже они могут вывести из себя. Сначала долго ищешь нужную инструкцию. Потом разбираешься в малопонятном тексте. Делаешь как написано, а проблема не решается. Ищешь другую статью, нервничаешь… Через час плюёшь на всё и уходишь. Так работает плохая документация. Что делает её такой, и как это исправить — читайте под катом.
Читать полностью »
Вредные советы: как правильно писать техническую документацию?
2019-02-23 в 11:43, admin, рубрики: guidelines for users, technical guidelines, Блог компании Parallels, техническая документация, технический писатель, управление проектами, управление разработкойСоветы по грамотному написанию технической документации для пользователей.
Часть 1
В одной из предыдущих статей мы в общих чертах рассказывали, как именно происходит процесс документирования и локализации наших продуктов.
На этот раз под катом – руководство нашего технического писателя Андрея Старовойтова, которое поможет сделать вашу документацию для пользователей проще и понятнее (описанные приемы применяют при документировании своих продуктов Apple, Microsoft и другие компании).
Читать полностью »
50 вопросов для работы над документацией
2018-11-29 в 6:58, admin, рубрики: help, ISPsystem, Блог компании ISPsystem, бриф, справка, справочная документация, технический писатель, Учебный процесс в ITКак бы ни старался UX-дизайнер, не сможет человек с улицы разобраться в интерфейсе управления космическим кораблём без подсказки. И даже не с улицы. Просто потому, что ракета большая и настроек много.
Мы делаем продукты попроще софта для ракет, но всё равно технически сложные. Очень стараемся, чтобы интерфейсы новых версий были простыми, но осознаём — всегда найдётся пользователь, который что-нибудь не поймёт и пойдёт в документацию. Поэтому дока должна быть, а чтобы не портить впечатление о продукте, она должна быть полезной и удобной.
У нас шесть продуктов, документацию к которым 13 лет писали разработчики. Уже полгода мы переписываем старые и пишем новые статьи. Под катом — 50 вопросов, которые помогают нам делать это хорошо. Но для начала немного вводных.
CoLaboratory: «ProКонтент 2.0». Ближе к пользователю
2017-02-16 в 22:05, admin, рубрики: UX, Блог компании «Лаборатория Касперского», копирайтинг, локализация приложений, Локализация продуктов, переводы, редактирование, технический писатель, управление проектамиЕсть два типа компаний: первые ориентированы на пользователей, вторые — на свой продукт. По мере того как бизнес растет, часто главным для него становится продукт, который необходимо развивать и поддерживать, а забота о клиенте отходит на второй план.
При всех своих масштабах и линейке более чем из 60 настраиваемых решений «Лаборатория Касперского» действует прежде всего в интересах пользователя. Важная часть нашей работы — тексты: мы общаемся с пользователями наших продуктов с помощью элементов интерфейса и документации.
Год назад в «Лаборатории Касперского» прошла первая встреча «ProКонтент» для технических писателей, редакторов, переводчиков и локализаторов. 16 марта 2017 года мы вновь приглашаем к себе всех желающих, чтобы раскрыть свои секреты и поговорить о том, что нас объединяет. О контенте.
Читать полностью »
Цели, задачи и принципы автоматизации
2016-12-14 в 1:38, admin, рубрики: Анализ и проектирование систем, гост, коммерческие предложения, технический писатель, техническое задание, управление проектамиРаботая в компании, которая занимается системной интеграцией, мне приходилось много раз читать и дополнять документы типа ТКП, ТЗ по ГОСТу, Планы приемки и прочее. Проекты по автоматизации предприятий преследовали похожие цели и имели приблизительно одинаковый формат. Одни и те же фразы повторялись из документа в документ.
Я решила собрать самые распространенные фразы, попадавшие в раздел «цели и задачи». И добавить принципы, которых следует придерживаться при формировании решений.
Список не универсальный. Буду рада, если кому-то это поможет при написании документов.
С другой стороны, некоторые принципы, собранные в этом списке — это мое понимание того, к чему должны стремиться как и большие корпорации, так и отдельные команды по разработке продуктов. Ступеньки на пути к информатизации общества.
Я призываю придерживаться многих из этих принципов в своей работе, чтобы держаться некой планки, ниже которой — просто уже не современно быть.
Log in или Log on? Front-end или Frontend? Продолжаем разбираться
2016-11-14 в 6:09, admin, рубрики: IT-стандарты, английский язык, документирование, Разработка веб-сайтов, разработка мобильных приложений, технический писатель
В прошлый раз мы говорили о разнице между login и log in. В продолжение темы — ещё несколько нюансов, о которых вы просили рассказать в комментариях.