День технического перевода. Степан ЖуринГазета «Лицейский вестник» и «Лицейское телевидение»15 октября 2019. Доклад Марии Макеевой на конференции AnalystDays #17 27-28 октября 2023. г. Москва Россия В этот четверг (25.11) в 18-00 пройдет презентация профессии технический писатель и команды технических писателей Orion Innovation. Во Всемирный день писателя вручаются награды и премии проявившим себя литературным деятелям.
Обязанности технического писателя
Вторая часть Дня технического творчества проходила на базе СПДС «Иволга», где участники трансляции посетили Хобби-клуб для родителей «Успех». Один или два параграфа о том, почему вы самый крутой писатель технических новостей в блоке. Опыт работы в должности бизнес-аналитика или технического писателя от 1 года. Технический писатель: Новые тенденции и требования в документации '23 from Vlad Orlikov.
Работа технического писателя в IT-компании: цели, зоны роста, кому подходит
Вторая часть Дня технического творчества проходила на базе СПДС «Иволга», где участники трансляции посетили Хобби-клуб для родителей «Успех». Смотрите онлайн самые последние и важные новости канала ОТР на официальном сайте. В свою очередь, технический писатель вносит исправления и проверяет, чтобы они соответствовали остальному тексту.
Какие знания и навыки нужны
- Забыли пароль?
- День из жизни технического писателя.
- TechWriter Days
- Наука и техника
НОВОСТИ ДНЯ
Эта замечательная выставка рассказывает нам о писателе и человеке, который понимает, чувствует, любит. Он оставил после себя творчество, которое необходимо, прежде всего, нашим детям. Нужно обязательно знакомить детей с произведениями Анатолия Митяева, они хрестоматийные. Леонид Носарев На открытии выставки выступила Татьяна Окружная, директор Рязанской областной детской библиотеки. Она представила сборник «Сказки у костра», переизданный к столетию А. Митяева: Я приехала, чтобы передать вам привет из родных мест Анатолия Васильевича, из Рязанской области: он родился в посёлке Ястребки Сапожковского района. Анатолий Васильевич очень любил свою родину, приезжал несколько раз к нам в Рязань, видел свою школу, в которой учился.
Мы все очень разные: по возрасту, характеру, увлечениям и образованию. Но нас объединяет одно общее интересное дело — документирование сложных систем и решений.
Бэкграунд Меня зовут Александр Клименков, я — ведущий технический писатель, кандидат технических наук по специальности «Системный анализ, управление и обработка информации», закончил Санкт-Петербургский электротехнический университет «ЛЭТИ». В компании Bercut работаю более 5 лет, очень люблю свою профессию. До прихода в Bercut работал преподавателем, техническим писателем и ведущим бизнес-аналитиком. Процессы и коммуникации в новой дистанционной реальности Как и большинство наших коллег в IT-сфере, сейчас мы работаем из дома. Переход на удалённый режим работы, конечно, внёс некоторые коррективы в нашу повседневную деятельность, но рабочие процессы от этого почти не поменялись. Мы всё так же пишем пользовательскую документацию, всё так же общаемся с коллегами в Teams и Skype, пользуемся теми же рабочими инструментами и серверами. Разве что звонки по местным телефонам мы заменили перепиской и созвонами в мессенджерах. Биоритмы и конвенции Режим рабочего дня, как и процессы, тоже не особо изменился.
Ещё до перехода на удалённый режим в нашей компании каждый сотрудник мог выбирать время начала рабочего дня: кто-то приходил на работу в 8 утра, кто-то — в 11. Главное, чтобы все были на месте в определённый дневной период и работали положенные 8 часов. На удалёнке эти правила сохранились. Среди нас есть свои «совы» и «жаворонки» и каждый начинает рабочий день в удобное ему время. В любом случае проснуться можно попозже — ведь не нужно тратить время на утренние сборы и дорогу до работы. Типичное рабочее утро писателя начинается с кружки крепкого кофе и обновления локальной копии из SVN. Нужно загрузить к себе изменения, которые другие писатели сделали за прошлый день. У читателя, не знакомого с нашей профессией, может сразу возникнуть вопрос: что же писатели хранят в SVN, ведь это не программисты, исходников у них нет.
В том-то и дело, что есть. Об этом нужно рассказать подробнее. Это формат, основанный на XML, который позволяет сохранять исходный текст документов в структурированном виде. Затем из этих исходников мы можем собрать итоговый документ в любом нужном формате. Наш Toolkit позволяет собирать документы во множестве форматов. При желании мы можем собрать даже EPUB, если заказчик вдруг захочет почитать нашу документацию перед сном на электронной книге. По необходимости мы вносим правки в XSLT-преобразования, чтобы изменить правила сборки документов и их внешний вид. Подробнее о формате Формат DITA вообще оказался очень удобным инструментом именно для разработки технической документации с её специфическим содержанием.
Например, мы можем повторно использовать любой блок текста или целый раздел из одного документа в другом документе. И это будет не привычный «copy-paste», а именно использование одного блока в разных документах. Если в этом блоке что-то изменится, нам достаточно будет поменять текст один раз — изменение автоматически попадёт во все документы. Ещё мы можем применять фильтрацию — написать один универсальный раздел, вставить в несколько документов и потом фильтровать его содержимое в зависимости от типа документа, заказчика, системы и других параметров. А ещё мы не задумываемся о перекрёстных ссылках между разделами — достаточно в нужном месте указать ключ раздела, на который мы хотим сослаться. Toolkit при сборке документа сам пронумерует разделы и сделает красивые гиперссылки.
В отличие от копирайтинга, здесь меньше творчества и больше регламентов. Soft skills и Hard skills технического писателя в концепции Модели компетенций команды цифровой трансформации в системе государственного управления подробно описаны в Профиле роли.
Технический писатель должен сочетать в себе свойства технаря и гуманитария. Интерес к технике и программированию, усидчивость и внимательность должны в нём сочетаться с желанием осваивать новое и делиться своими знаниями. Очень важно знать предметную область, в которой ведется работа. Например, если вакансия открыта в ИТ-компании, потребуется знать языки программирования и разбираться в процессах разработки софта. Список ПО зависит от отрасли, в которой трудится специалист. Нужно уметь работать в команде, общаться с разработчиками и понимать пользователей, которые будут использовать продукт. Часто работа идет в стандартных текстовых редакторах и программах для работы с изображениями. В некоторых IT-компаниях требуется, чтобы технический писатель знал языки разметки текста или один из языков программирования на уровне чтения кода, другим важны навыки работы с базами данных или в системах управления запросами.
То, что пригодится точно — интерес к той сфере, о которой технический писатель работает. Некоторые работодатели требуют, чтобы образование у технического писателя было техническим. Другим нужно просто высшее образование. Еще одно требование — знание иностранного языка, потому лингвисты, филологи, переводчики тоже востребованы. Хорошо пишут тексты и коммуникабельны, как правило, выпускники гуманитарных направлений: литераторы, журналисты. Если человеку с таким образованием понравится разбираться в новой для себя области, то, скорее всего, ему подойдет эта профессия. Часто думают, что технический писатель — это профессия, не требующая особых коммуникативных навыков. На практике оказывается, что для написания документации каждый день приходится консультироваться со множеством коллег: бизнес-аналитиками, разработчиками, тестировщиками.
Бывает так, что в исходных документах авторы что-то опускают, что-то недоговаривают. Работа технического писателя — быть профессиональным занудой: уточнять, переспрашивать, перепроверять информацию много раз, чтобы правильно всё описать и не допустить ошибку в документе. Бывают случаи, когда писатели находят ошибки в реализации. Кому нужен технический писатель. Если проект небольшой, то возможно, технический писатель совсем не нужно. Но есть огромные преимущества, когда в проекте есть технический писатель. Технические писатели четким языком излагаю информацию. Большинство технических специалистов являются экспертами в своей области, они формируют описание продукта для равной себе аудитории.
Для конечных же пользователей нужны совершенно другие инструкции. Технические писатели по своей сути являются переводчиками с языка разработчиков на простой язык, который требуется пользователям продукта. Особенно важно сочетание слов и графики — именно такой формат позволяет создать инструкцию, понятную всем участникам проекта. Кроме того, технические писатели смогут оказать помощь в изменении пользовательского интерфейса продукта, что позволит снизить потребность в документации. Документация хорошего качества положительно влияет на продукт. Грамотные и понятные инструкции уменьшают количество обращений в отдел технической поддержки: Технические писатели думают о задаче с точки зрения пользователя, а не разработчика. Поэтому они лучше объясняют, как пользователи могут достичь своих целей. Технические писатели могут усовершенствовать доступ к информации, и таким образом снизить количество обращений в техподдержку, которое несомненно возрастает, если пользователи не могут найти необходимую им информацию.
Документируя продукт, технические писатели тестируют его, чтобы узнать, как он работает на самом деле. В это время они часто обнаруживают баги или проблемы с удобством использования. Устранив эти проблемы до релиза продукта, можно быть уверенным, что пользователи никогда не столкнутся с ними.
Когда и где: 17-19 мая, Миннеаполис, США. Июнь Каждый год специалисты по технической коммуникации, включая разработчиков информации, технических писателей, технических редакторов и переводчиков, собираются на мероприятии Evolution of TC, которое фокусируется на новых разработках в области документации программного обеспечения. Данное мероприятие является единственной техкомм конференцией в Юго-Восточной Европе. Для получения более подробной информации обращайтесь на сайт конференции. Когда и где: 4-5 июня, София, Болгария. Knowledge Conf 2024 Программа конференции Knowledge Conf охватывает широкий спектр аспектов управления знаниями. В ее рамках рассматриваются как прикладные задачи, включающие в себя обучение новичков, организацию базы знаний, создание внутренних университетов, а также практическое обучение, так и фундаментальные аспекты, такие как применение современных методов обучения и развитие системного мышления.
Мероприятие позиционируется как профессиональная конференция по управлению знаниями и ее программа отражает этот слоган. Когда и где: 27-28 июня, Санкт-Петербург, РФ. Целью конференции является распространение существующих и создание новых знаний об архитектуре программных решений. Несмотря на то, что данное мероприятие не ориентировано на технических писателей, некоторые темы докладов могут быть интересны и им. Конференция также будет проводиться онлайн, что позволит участвовать в ней без необходимости поездок. Когда и где: 1 ноября, Москва, РФ. Зачем техписам конференции? Итак, зачем же всё-таки техническим писателям посещать конференции?
Технический писатель
Со временем замечаешь, что на вопросы в рабочих чатах разработчики отвечают ссылкой на документацию. Хорошая новость: чтобы работать техписом в команде разработки, необязательно иметь техническое образование. Достаточно желания разбираться в новом материале и работать с текстами. Личные качества технического писателя В отличие от многих других направлений в IT, в профессии технического писателя личные качества имеют значение. Подготовка технической документации — кропотливая, монотонная работа, требующая усидчивости и внимания к деталям. Это подойдёт не каждому.
Дело осложняется тем, что вроде бы полностью интровертивный набор качеств сопровождается требованием к высокой коммуникабельности и стрессоустойчивости, поскольку выяснение деталей у разработчиков и сбор требований к пользователей и сотрудников требует железной выдержки и умения не принимать всё близко к сердцу. Кирилл Наумов руководитель группы документации для разработчиков Ozon Tech Я стал техписом, потому что с детства постоянно читал, в основном русскую классику, и язык мне даётся интуитивно. Всегда любил писать сухие технические тексты и не любил эссе. Даже этот рассказ о себе мне сложно писать. Я отучился год на журфаке, а потом перешел в вышку на менеджмент.
Оба образования мне пригодились, потому что со временем я стал лидом. В работе техписа мне нравится упорядочивание — из страшного сумбурного текста делать стройный и понятный. Кроме того, сейчас я параллельно выступаю как бизнес- аналитик для небольшой команды разработки. Опыт техписа там тоже пригодился, потому что приходится много писать требования и другую проектную доку. Можно сказать, что прямо вот пишет технический писатель значительно меньше, чем собирает, анализирует, общается, уточняет.
Очень дипломатичная профессия, в общем :- Вопросы, которые могли остаться Разве не лучше, если писать будут разработчики? Нет, не лучше, хотя часто именно так и происходит. Во-первых, это отнимает время разработчика, во-вторых, он не стремится сделать понятно, а пишет на своём языке, в-третьих, многие вещи ему кажутся простыми, понятными и очевидными и он не считает нужным даже упоминать их. Между тем для пользователя такие мелочи могут оказаться дремучим лесом. А если технический писатель ошибся?
Документация проходит контроль качества в отделе тестирования, как и весь комплекс программного обеспечения или инженерных решений. Однако всем свойственно ошибаться — и здесь уже компания оценивает критичность ошибки и выстраивает модель безопасности технической документации например, неправильно описанная функция в ERP-системе может не повлечь урон, а вот ошибка в мануале к банковскому или инженерному ПО может стоить слишком дорого. Технический писатель — это технический или писатель? И то и другое, поскольку это взаимодополняющие качества, делающие специалиста уникальным. Думается, что технические писатели — это одни из тех, кого долгое время не смогут заменить даже самые умные нейронки, поскольку за выдачей контента стоит огромная синтетическая и аналитическая работа, основанная на знании ПО, архитектуры и процессов.
ИИ это не под силу.
Темы сюжетов — события из жизни страны, внутренние и международные общественно-политические процессы. Выходили и специальные выпуски, посвященные очередному съезду КПСС, выборам, праздничным датам, торжественным похоронам видных государственных и политических деятелей. С 1984 года журнал поменял своё название на «Хроника наших дней» изменились заставка и музыка журнала.
Положила учебник на коленки :grin: Учитель заметил, конечно, и влепил двойку. А ещё один раз я написала сочинение по какому-то произведению и получила 2 за то, что поняла его не так, как учитель". Уже не помню, почему так случилось, помню только как мне было страшно и стыдно рассказывать об этом дома :scream: Когда приходила исправлять, учительница всё приговаривала: ну как же так, ты же умная девочка, неужели не вспомнила вот это правило? Часто писала по 6-7 страниц текста, а не сделать ошибок в таких длинных текстах сложно".
Если человеку с таким образованием понравится разбираться в новой для себя области, то, скорее всего, ему подойдет эта профессия.
Часто думают, что технический писатель — это профессия, не требующая особых коммуникативных навыков. На практике оказывается, что для написания документации каждый день приходится консультироваться со множеством коллег: бизнес-аналитиками, разработчиками, тестировщиками. Бывает так, что в исходных документах авторы что-то опускают, что-то недоговаривают. Работа технического писателя — быть профессиональным занудой: уточнять, переспрашивать, перепроверять информацию много раз, чтобы правильно всё описать и не допустить ошибку в документе. Бывают случаи, когда писатели находят ошибки в реализации. Кому нужен технический писатель. Если проект небольшой, то возможно, технический писатель совсем не нужно. Но есть огромные преимущества, когда в проекте есть технический писатель. Технические писатели четким языком излагаю информацию.
Большинство технических специалистов являются экспертами в своей области, они формируют описание продукта для равной себе аудитории. Для конечных же пользователей нужны совершенно другие инструкции. Технические писатели по своей сути являются переводчиками с языка разработчиков на простой язык, который требуется пользователям продукта. Особенно важно сочетание слов и графики — именно такой формат позволяет создать инструкцию, понятную всем участникам проекта. Кроме того, технические писатели смогут оказать помощь в изменении пользовательского интерфейса продукта, что позволит снизить потребность в документации. Документация хорошего качества положительно влияет на продукт. Грамотные и понятные инструкции уменьшают количество обращений в отдел технической поддержки: Технические писатели думают о задаче с точки зрения пользователя, а не разработчика. Поэтому они лучше объясняют, как пользователи могут достичь своих целей. Технические писатели могут усовершенствовать доступ к информации, и таким образом снизить количество обращений в техподдержку, которое несомненно возрастает, если пользователи не могут найти необходимую им информацию.
Документируя продукт, технические писатели тестируют его, чтобы узнать, как он работает на самом деле. В это время они часто обнаруживают баги или проблемы с удобством использования. Устранив эти проблемы до релиза продукта, можно быть уверенным, что пользователи никогда не столкнутся с ними. К тому же, технические писатели часто формируют более целостный взгляд на продукт, чем может получиться у разработчиков, которые должны сосредотачиваться каждый на своей небольшой части продукта. Технические писатели накапливают полезный опыт, работая с пользовательскими интерфейсами — это то, что большинство разработчиков никогда формально не изучали. Предлагая рационализированный, более эффективный вариант интерфейса, технический писатель освобождает время разработчиков, которое они смогут потратить на более трудоёмкие задачи по созданию корректно работающего кода. Технические писатели могут писать лаконичнее без потерь в качестве, что в результате даёт более короткие инструкции и сниженные расходы на печать: менее объёмные документы требуют меньше времени на проверку, тем самым снижаются расходы на неё; на коротких документах проще сосредоточиться, соответственно улучшается качество проверки. Основная работа технического писателя — писать, и профессиональные писатели создают документацию быстрее, чем разработчики продукта. Даже если найдётся тот редкий разработчик, который пишет быстро и эффективно — он запросто может обойтись вам в два раза дороже по оплате труда в час, чем технический писатель, и пока пишет, он не будет производить ничего, что вы сможете продать.
Наём технического писателя не только снижает затраты на разработку документации, но и освобождает разработчиков продукта для работы, на которую они были наняты. Даже если «этот снаружи» сидит в соседней команде. Любое погружение посторонних в проект или продукт уже подразумевает документацию, а, следовательно, и позицию технического писателя. Но у меня в практике был проект, когда документации нет и это не создаёт никаких реальных проблем. Вот тогда и писатель не нужен. Или к примеру, у меня в команде был такой разработчик, что он прекрасно пишет документацию и ему проще сделать это самому — вот такое у него хобби » Максим, директор департамента разработки ИТ-компании Какую карьеру может построить технический писатель? Технический писатель может выбрать для себя разные пути развития. Очень многое зависит от проекта, над которым работает технический писатель. Если брать сферу IT, ближе всего к техническому писателю профессия бизнес-аналитика.
: техническим писателем ✒
Часто люди обращаются к инструкциям только тогда, когда становится совсем непонятно или что-то идет не так. Хорошо, если это произойдет до того, как что-нибудь будет сломано, иначе скажут — продукт плохой. Технический писатель должен предусмотреть такие ситуации: предупредить о возможной поломке, описать ее, предложить решение. Что делает технический писатель Профессиональные знания, умения и навыки технических писателей конкретизированы и уточнены сообразно отраслевой и профессиональной специфике в Профстандарте технического писателя.
Проекты разные, и набор того, что и для кого задокументировать, не всегда одинаковый. Одному проекту достаточно подробной инструкции для технических специалистов, другим потребуется пакет документов и для поддержки, и для обычных пользователей. Технические тексты считаются хорошими, если написаны точно, последовательно, но при этом кратко и понятно.
В таких текстах важно, чтобы информация была структурированной, чтобы в них были списки, таблицы, схемы. Часто именно небольшой список помогает пользователю быстрее, чем длинное описание на двадцати страницах. В технических текстах обычно много иллюстраций, скриншотов интерфейсов, видео.
Это нужно, чтобы человек сравнил картинку на инструкции с тем, что видит на мониторе, понял, что действует правильно, и настроил систему по шагам на картинках «В моей работе главное ориентироваться на конечного потребителя: как с помощью технической документации он будет решать свои задачи, какой у него уровень подготовки и насколько подробно все должно быть заложено в инструкции. К примеру, я сейчас работаю над частью внутренней информационной системой, которой будут пользоваться технические специалисты. Поэтому основные требования — подробная и длинная инструкция с множеством скриншотов и примеров, которые позволят пользователю решить разные задачи.
А в другом проекте я пишу небольшую часть документации по функциональности продукта для обычных пользователей. Здесь тексты простые, информативные и доступные. Моя основная задача — сделать так, чтобы и системный администратор, и обычный пользователь нашли в инструкции то что ищут и этот поиск не занял много ресурсов».
Приступая к написанию любой инструкции, технический писатель анализирует многочисленные источники информации и преобразует полученные оттуда данные в пользовательскую документацию. Самый главный источник — это технический проект ТП , которые пишут бизнес-аналитики ещё до начала разработки. Технический проект — это закон для разработчиков, тестировщиков и технических писателей.
В идеале всё должно быть реализовано именно так, как написано в ТП. На деле же оказывается, что итоговая реализация отличается от ТП: что-то не учли, что-то поняли неправильно, что-то оптимизировали. Для того, чтобы узнать, как на самом деле всё было реализовано, используется техническое описание ТО , которое пишут разработчики.
Там есть больше технических подробностей, описаны изменения конкретных типов данных и таблиц в БД, приведены алгоритмы работы процедур серверного кода, приведены скриншоты добавленных или изменённых окон в клиентских приложениях. Есть ещё один важный источник — описание настроек интеграционного тестирования. Там подробно описаны все настройки, которые нужно сделать в системах, чтобы пройти все тестовые сценарии тест-кейсы.
Этот источник незаменим для написания руководств по настройке. Технический проект, техническое описание и описание настроек — это основные источники, из которых писатель получает информацию. Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах.
Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении. Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано.
Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация. Процесс работы технического писателя.
Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего. Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать.
Срочно бегу в душ! Время: 10. Теперь можно полноценно позавтракать!
Овсяная каша, огурец, помидор, хлеб и чай - радость для моего организма 11. Кошка тоже считаешь, что давно пора опять есть и составляет мне приятную компанию: 12. Завтрак поглощен, посуда помыта, кошка довольна, время: 13.
До выхода из дома осталось чуть меньше двух часов, надо срочно позаниматься за фортепиано, а погодка кстати налаживается, выглядывает солнышко. Может быть, синоптики обманули нас с дождем? Позанималась вполне продуктивно, выучила 4 такта, которые никак не получались три дня подряд.
Кошечка считает что ей тоже нужно заниматься, при чем срочно! Иначе кого-то покусают. Гимнастика с красной ленточкой: 15.
После утомительных упражнений, я желаю кошке хорошенько выспаться и отдохнуть, она мне тоже желает не перетрудиться: 16. Пора выходить на работу. Время: 17.
На бегу включаю плеер, самое время послушать Рахманинова! Выхожу из подъезда, а дорогу мне перебегает черный котейка.
Пожалуйста, дополните ваш отзыв","employerReviews. Попробуйте повторить операцию позднее","employerReviews. После модерации он появится на сайте Dreamjob. Отображается последний отзыв. Попросим работодателя открыть отзывы","employerReviews. Возможно, сама компания рассказала о них в вакансии — посмотрите описание.
Поэтому какое-то время мечтала стать писателем. Бойтесь своих желаний, как говорится ". Последние записи:.
Работа технического писателя в IT-компании: цели, зоны роста, кому подходит
Технический день в модельной библиотеке им. М. Е. Салтыкова-Щедрина перенесен на 22 февраля. В Новом здании Российской национальной библиотеки (Московский пр., д.165 к.2) начала работу выставка «Затеси» Виктора Астафьева», приуроченная к 100-летнему юбилею русского писателя и драматурга. 165 лет со дня рождения русского учёного, писателя. Константина Эдуардовича Циолковского (1857-1935) День работника дошкольного образования. технические характеристики mitsubishi galant 25 i vr-4 type-v 4wd.