Технические писатели. Конференция для технических писателей – это событие, организованное с целью собрать и объединить специалистов, занимающихся технической документацией. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского.
Один день технического писателя
Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. Самые свежие новости России и мира, новости политики, шоу-бизнеса. На сайте в рубрике «Наука и техника» всегда свежие новости за день и неделю. Технический писатель: Новые тенденции и требования в документации '23 from Vlad Orlikov.
Один день технического писателя
Конференция для технических писателей – это событие, организованное с целью собрать и объединить специалистов, занимающихся технической документацией. 21 апреля в ГУНБ в отделе технической литературы (3 этаж, каб. 301) пройдет День технической книги. за профессионализм, признание професии и чистоту русского языка (и в технических документах тоже)!
Физик и лирик. Технический писатель: Новые тенденции и требования в документации '23
Новые инсайты и практика технологического обновления в программе Дня технического специалиста Форума PulpFor 2023! 3 марта отмечается Всемирный день писателя. Этот праздник был учрежден в 1986 году по решению конгресса Международного ПЕН-клуба, который был основан в Лондоне в 1921 году. Технических писателей. Конференция предоставляет техническим писателям возможность обмениваться опытом, учиться новым методам и инструментам, а также повышать свой профессиональный уровень в области создания технической документации. В свою очередь, технический писатель вносит исправления и проверяет, чтобы они соответствовали остальному тексту.
«День с писателем».
Последние события в режиме онлайн: главные новости российского бизнеса и политики, международные события, криминальные происшествия, обзоры прессы, движения фондового рынка, лента спортивных новостей, автомобильные новости. Опыт подготовки технической документации (ГОСТ 19, ГОСТ 34); - Хороший уровень владения русским языком, грамотная письменная речь; - Умение структурировать и систематизировать информацию. Опыт работы в качестве технического писателя в области разработки и внедрения информационных систем от 3х лет. 5-6 апреля в Москве состоится 1-я Международная конференция технических писателей TechWriter Days. онлайн на сайте
Зачем нужны технические писатели
Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. Коллеги, наступил февраль, а с ним и День технического писателя — 2 февраля. На сайте в рубрике «Наука и техника» всегда свежие новости за день и неделю.
«День с писателем».
Требования: - Опыт подготовки технической документации ГОСТ 19, ГОСТ 34 ; - Хороший уровень владения русским языком, грамотная письменная речь; - Умение структурировать и систематизировать информацию; - Уверенное владение пакетом офисных приложений Word, Excel ; - Базовое понимание процессов разработки программного обеспечения. Контактные телефоны:.
Нихт, арбайтен, архитектура сама себя не опишет. Хочу помощи зала.
Пишу, рисую, разбираю рулбуки. Второй великий обеденный поход. По правде говоря, было очень средне, обычно готовят намного вкуснее.
Десять минут на обед, надо подготовиться к стендапу. К стендапу надо отчитаться о проделанной работе, и что планирую сделать на сегодня. Командой обсуждаем наработки.
На всё про всё минут 15, продуктивно и не затратно. Планов у команды много, идей еще больше.
Я сижу весь день уткнувшись в PHP-код, часто с угрюмым лицом, иногда среди тишины раздаются мои возгласы или возгласы программиста. Изредка смех технической поддержки и ооооооочень редко ворчание начальника. Конец рабочего дня официально в 7 вечера, но голова пухнет от компьютера и программного кода, меня ждет друг и я сбегаю из офиса. Время: 25.
Мы встретились и решили пойти в Парк Горького, я давно не была и мне все рассказывали, как здорово там сейчас сделали. А еще я сначала совсем забыла, что нужно фотографировать всё вокруг и вспомнила только на милых уточках: 26. Этой мой друг. Друга зовут Максим. Мы хотели покататься на лодках, но там была огромная очередь! Тогда мы решили пойти на набережную и разузнать, как ходят речные трамвайчики.
Пока шли, я увидела судно интересного цвета: 28. Трамвайчик скоро отходил и был полупустой, нам несказанно повезло А еще вокруг нас ходили тучи, но ни капельки не упало, тоже очень удивительно. Памятник Петру Первому. Если кто-то не знает историю памятника, могу немножко рассказать: изначально это был памятник Колумбу, созданный господином Церетели, который безуспешно предлагал его купить США, Испании и странам Латинской Америки, а они сказали, что им такая какашка такой памятник без надобности. В итоге получилось нечто странное. Флаги к нам особого отношения не имеют, одежда того времени явно относится к веку, в котором Петра вообще не было.
Ну зато голова есть.
Чтобы в этом случае не было конфликта правок, у нас есть специальный чат, где можно оповестить своих коллег о начале работы с определённой частью документа или об обновлении общих коллекций, например — глоссария. Может, это и не самое технологичное решение, но оно работает. Никому из писателей не хочется потом «мёржить» merge куски сложных технических текстов.
После обновления локальной копии SVN начинается работа. Мы работаем по задачам в Jira. У нас есть специальный тип задач с префиксом DOC. Обычно они связаны с задачами на разработку или с запросами заказчиков.
Задачи на документирование создают менеджеры, которые ведут проект, тестировщики, сотрудники службы поддержки. Заказчик тоже может инициировать изменение документации, задав вопрос, высказав пожелание или жалобу. Team Lead нашей команды планирует деятельность каждого писателя, распределяет задачи, следит за их выполнением и отгрузкой документов. Для всех участников процесса разработки главное — не забыть создать задачу, ведь писатели должны откуда-то узнать о том, что что-то нужно задокументировать.
К сожалению, у нас всё ещё бывают такие ситуации, когда подходит срок отгрузки новой системы, а заявка на документирование этой системы не создана. В этом случае чуда не произойдёт — документация не появится моментально. Внутренняя «кухня» — источники вдохновения Начиная работать над очередной задачей, писатель изучает многочисленные источники информации и преобразует полученные оттуда данные в пользовательскую документацию. Источников у нас много.
Самый главный — это технический проект ТП , которые пишут бизнес-аналитики ещё до начала разработки. ТП — это закон для разработчиков, тестировщиков и технических писателей. В идеале всё должно быть реализовано именно так, как написано в ТП. На деле же оказывается, что итоговая реализация отличается от ТП.
Вы знаете, как это бывает: что-то не учли, что-то поняли неправильно, что-то оптимизировали… Для того, чтобы узнать, как на самом деле всё было реализовано, мы используем техническое описание ТО , которое пишут разработчики. Там есть больше технических подробностей, описаны изменения конкретных типов данных и таблиц в БД, приведены алгоритмы работы процедур серверного кода, приведены скриншоты добавленных или изменённых окон в клиентских приложениях. Без ТО нам было бы очень трудно написать полноценную документацию. К сожалению, разработчики иногда откладывают написание ТО на самый последний момент.
Есть ещё один важный источник — описание настроек интеграционного тестирования. Там подробно описаны все настройки, которые нужно сделать в системах, чтобы пройти все тестовые сценарии тест-кейсы. Этот источник незаменим для написания руководств по настройке. ТП, ТО и описание настроек — это основные источники, из которых писатель получает информацию.
Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах. Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении. Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано.
Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца.
С Днем технического писателя!
Поэтому какое-то время мечтала стать писателем. Бойтесь своих желаний, как говорится ". Последние записи:.
Здесь пройдет практическое занятие. Им предложат попробовать написать поэтические строки. Покажут, как использовать разные стихотворные размеры и рифмы, применять игру слов. Часть беседы посвятят феномену авторского вдохновения и тому, как оно влияет на литературный труд и его результат.
Для участия необходимо купить билет на экскурсию, а также отдельно приобрести билет на постоянную экспозицию музея «Слово». В этот же день в 19:00 в музее «Слово» состоится еще одна писательская экскурсия. На ней речь пойдет о создателях древних книг — монахах-переписчиках. Они не только сохраняли и тиражировали духовные и летописные знания, но и сыграли важную роль в появлении авторских сочинений. Помимо этого, экскурсанты узнают о том, какие сообщения писали друг другу люди на берестяных грамотах. Затем они познакомятся с первыми произведениями русских путешественников, которые назывались хождениями. А еще гостям покажут уникальный памятник русской литературы XVII века — «Житие протопопа Аввакума, им самим написанное».
Протопоп Аввакум положил начало такому жанру, как автобиография. Например, гости узнают, как возникло русское стихосложение и почему Александр Пушкин до сих пор считается главным русским поэтом. Посещение экскурсии и музея бесплатное. Любители русской литературы 3 марта могут посетить выставку «Лев Толстой. Гости ВДНХ пог рузятся в атмосферу первой половины XIX века и в интерактивном формате познакомятся с творчеством великого русского писателя. Экспозиция состоит из 13 тематических разделов.
В армии он служил заместителем командира саперного батальона, причем в звании рядового. Он предложил наладить выпуск для фронта дистанционно управляемых торпед-танкеток, его изобретение использовали во время прорыва блокады Ленинграда. Но самую ценную награду, именно за свою торпеду — специальную изобретательскую медаль, — я получил через полвека после войны», — рассказывал Александр Казанцев. Как писатель-фантаст Александр Казанцев дебютировал в 1936 году на конкурсе киносценариев. В соавторстве с Израилем Шапиро он написал сценарий фантастического фильма «Аренида» об астероиде, который грозит уничтожить Землю. Эта работа заняла первое место на конкурсе.
В 1924-м году Владимир поступил в Государственный Техникум Кинематографии, где обучался на художественном факультете. Интересно, что вместе с Сутеевым учился его двоюродный бат Дмитрий Боголепов , ставший в дальнейшем известным режиссером. Еще во времена студенчества Сутеев стал членом экспериментальной группы мультипликаторов. Мультипликационный дебют мужчины состоялся во время его работы над картиной «Китай в огне».
Все новости
The conference provides access to current trends, innovative tools, and best practices in the field of technical documentation. Companies can learn about new methods of documentation creation and implement them into their processes. Employee Training. Participation of company employees in the conference serves as a form of continuous learning. Employees can enhance their knowledge and skills, which, in turn, can improve the quality and efficiency of technical documentation creation. Experience Sharing and Networking. The conference offers a unique opportunity to exchange experiences with colleagues from other companies. This can help expand the professional network, discover new ideas and solutions, and establish potential partnerships.
Enhancing Company Visibility. Company participation as a conference partner can increase visibility and the dissemination of information about its products and services. It can also attract the attention of potential customers and partners. Receiving Feedback.
Технические писатели могут усовершенствовать доступ к информации, и таким образом снизить количество обращений в техподдержку, которое несомненно возрастает, если пользователи не могут найти необходимую им информацию. Документируя продукт, технические писатели тестируют его, чтобы узнать, как он работает на самом деле. В это время они часто обнаруживают баги или проблемы с удобством использования. Устранив эти проблемы до релиза продукта, можно быть уверенным, что пользователи никогда не столкнутся с ними. К тому же, технические писатели часто формируют более целостный взгляд на продукт, чем может получиться у разработчиков, которые должны сосредотачиваться каждый на своей небольшой части продукта.
Технические писатели накапливают полезный опыт, работая с пользовательскими интерфейсами — это то, что большинство разработчиков никогда формально не изучали. Предлагая рационализированный, более эффективный вариант интерфейса, технический писатель освобождает время разработчиков, которое они смогут потратить на более трудоёмкие задачи по созданию корректно работающего кода. Технические писатели могут писать лаконичнее без потерь в качестве, что в результате даёт более короткие инструкции и сниженные расходы на печать: менее объёмные документы требуют меньше времени на проверку, тем самым снижаются расходы на неё; на коротких документах проще сосредоточиться, соответственно улучшается качество проверки. Основная работа технического писателя — писать, и профессиональные писатели создают документацию быстрее, чем разработчики продукта. Даже если найдётся тот редкий разработчик, который пишет быстро и эффективно — он запросто может обойтись вам в два раза дороже по оплате труда в час, чем технический писатель, и пока пишет, он не будет производить ничего, что вы сможете продать. Наём технического писателя не только снижает затраты на разработку документации, но и освобождает разработчиков продукта для работы, на которую они были наняты. Даже если «этот снаружи» сидит в соседней команде. Любое погружение посторонних в проект или продукт уже подразумевает документацию, а, следовательно, и позицию технического писателя. Но у меня в практике был проект, когда документации нет и это не создаёт никаких реальных проблем.
Вот тогда и писатель не нужен. Или к примеру, у меня в команде был такой разработчик, что он прекрасно пишет документацию и ему проще сделать это самому — вот такое у него хобби » Максим, директор департамента разработки ИТ-компании Какую карьеру может построить технический писатель? Технический писатель может выбрать для себя разные пути развития. Очень многое зависит от проекта, над которым работает технический писатель. Если брать сферу IT, ближе всего к техническому писателю профессия бизнес-аналитика. Там требуются схожие качества: внимание к деталям, аналитический склад ума, стремление разложить все по полочкам. Из технического писателя получаются прекрасные специалисты по тестированию. Технический писатель может стать менеджером проектов, попробовать себя в тестировании. Если человек писал много документации о программах на Java, заинтересовался и решил изучить этот язык программирования, он может стать разработчиком.
Некоторые технические писатели уходят в сферу маркетинга или продаж, особенное если это направление по продвижению IT-продуктов: умение структурировать информацию и наглядно представлять её помогает готовить презентации для потенциальных клиентов, а умение понимать нужды клиента или пользователя, предугадывать его вопросы, незаменимо в этой области. Многие технические писатели предпочитают работать на различных проектах: являясь фрилансерами, они вольны выбирать для себя наиболее интересные проекты, совершенствуя свои навыки в разных направлениях. Развиваясь, они становятся незаменимыми специалистами на биржах по поиску специалистов. Это интересно как самому техническому писателю, так и работодателю: специалист задействован на определенные задачи и трудовых отношений часто не возникает. Я всегда мечтала путешествовать, поэтому очень много время уделяла изучению иностранных языков. Журналистика не пошла, хотя очень нравилось писать технические тексты. Знакомые предложили попробовать себя в IT — необходимо было разобраться с высокотехнологичным продуктом в помощь основному техническому писателю. Вот с этого началось мое погружение в IT. Несколько лет я работала в компании, пока наконец не поняла, что хотела бы совмещать мою любовь к путешествиям и любимую работу.
Сейчас я фрилансер, заказы есть всегда, иногда даже привлекаю молодых специалистов к решению задач». Марина, технический писатель-фрилансер Заработная плата технических писателей. На июль 2021 года на известном ресурсе по поиску работы были найдены 335 вакансии по Москве и Московской области. С примером описания вакансии можно ознакомиться здесь. Средний размер заработной платы: от 100 000 до 150 000 рублей.
Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений. Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок. Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением. Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно. Для того, чтобы достичь единства в этом вопросе, в компании должен существовать единый глоссарий терминов. Простой пример: один и тот же объект во внутренних документах может называться «системным параметром», «параметром системы», просто «параметром» или даже «записью в таблице параметров». Для разработчиков системы может быть понятно, что всё это — один и тот же объект. Для пользователя же это совсем не так очевидно. Может быть, после некоторого размышления, он догадается, что все эти названия описывают одно и то же. Но мы же любим наших пользователей, зачем постоянно заставлять их решать подобные головоломки? Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания.
Тогда техпис собирает все возможные вопросы и идёт к хранителю выведывать информацию. Хранителем может быть любой человек из команды: разработчик, продакт, аналитик, юрист, дизайнер, кто угодно. Марина Вашак, технический писатель Умение писать коротко и по делу. Технический текст должен быть сухим, без лишних расшаркиваний. Техпис не гонится за количеством слов — наоборот, снимает с текста все «украшения»: обособленные обороты, составные глаголы, отглагольные существительные и прочую мишуру. Адекватное восприятие критики. Работа технического писателя — процесс творческий, поэтому надо быть готовым к замечаниям. Они будут всегда, потому что даже самый крутой специалист — человек, а люди ошибаются. Если полагаться только на своё мнение, есть шанс написать инструкцию, которую сможет понять только автор. Адекватная обратная связь. В дополнение к предыдущему пункту: технический писатель — это не только писатель, но и читатель. У разработчиков есть код-ревью. У технических писателей, если их больше одного, в идеальном мире есть ревью текстов. Потому что, опять же, все ошибаются, глаз замыливается, а две головы всегда лучше одной. И если нужно вычитать текст и дать обратную связь, понадобится много эмпатии и заинтересованности в общем результате, а не высокомерное «всё фигня, переделывай». Как понять, что работа мне подходит Возьмите приложение любимого банка и напишите инструкцию к какому-то простому процессу. Например, как оплатить мобильную связь. Покажите эту инструкцию друзьям или родителям, попросите проверить и попробовать пополнить баланс, следуя ей. Если инструкция сработала — поздравляю, это прекрасный старт, вы готовы к тестовым заданиям. Помониторьте вакансии для технических писателей без опыта и запросите тестовое задание. Вас попросят описать реальный кейс или подготовить простую инструкцию к бытовым действиям или вещам. Однажды мне дали задание: написать инструкцию к кошке. Пожалуй, это было самое милое тестовое. Я описывала кошку как самораспаковывающуюся систему. Подготовить платформу для установки и выбрать источник нужно заранее. Благодаря таким бытовым инструкциям можно оценить, как мыслит и пишет кандидат. А тестовые по реальным кейсам дадут представление о его умении разбираться в непонятных терминах и находить информацию. Марина Вашак, технический писатель Далеко не все компании дают обратную связь.
Технический писатель
Умение вести документооборот, знание в области ведения контрактной работы; умение быстро включаться в работу, адекватно воспринимать задачи и выполнять их в указанные сроки; Знание нормативной докуметации по ГОСТ 19, 34 желательно с применением на практике. Знание серии докуметов ГОСТ 2 желательно с применением на практике. Для работы требуются навыки делового общения как внутри организации, так и с заказчиками и исполнителями работ вне центра; работа в космической отрасли является преимуществом; Желательно обладать базовыми знаниями в области информационных технологий; Самоорганизованность, стрессоустойчивость.
К важнейшим профессиональным навыкам специалиста относятся умение четко и ясно излагать мысли в собственном тексте, знание технического английского языка, владение базовыми умениями программирования, графическими программами. Карьера Карьерного роста технический писатель может достигнуть, перейдя на работу в более крупную компанию, после того, как повысит свой профессионализм и наберется опыт, можно уйти в другую отрасль труда, стать техническим директором. Средняя заработная плата Средняя заработная плата по России технических писателей составляет от 40 до 90 тысяч рублей. Однако такая сумма условна, всё зависит от масштабности фирмы, стажа, профессиональных навыков сотрудника. О нас Образовательный портал TimeStudent для абитуриентов и студентов. Каталог учебных заведений, профессий, программ обучения, дни открытых дверей, новости и статьи об образовании.
Написал «Арктический мост», «Фаэты», «Тайна нуля», «Острее шпаги», «Клокочущая пустота» и многие другие книги. Его последний роман «Звезда Нострадамуса» вышел в 2000-м, а в 2001-м в соавторстве с сыном он написал фантастико-автобиографический роман «Фантаст». Несмотря на обширную библиографию, прозу Александра Казанцева экранизировали лишь однажды. Ведущий советский разработчик методов комбинированных съемок Павел Клушанцев снял фильм «Планета бурь» 1961 по одноименной повести, в которой герои отправляются на Венеру. В книге писатель впервые использует слово «инопланетянин», которое вошло в обиход и стало привычным для всех. Эту картину купили на Западе, причем показывали не только оригинальный вариант, но перемонтировали в два варианта с названиями «Путешествие на доисторическую планету» и «Путешествие на планету доисторических женщин».
Я снова за ноутом. После обеда, даже такого легкого, появилось желание поспать. Нихт, арбайтен, архитектура сама себя не опишет. Хочу помощи зала. Пишу, рисую, разбираю рулбуки. Второй великий обеденный поход. По правде говоря, было очень средне, обычно готовят намного вкуснее. Десять минут на обед, надо подготовиться к стендапу. К стендапу надо отчитаться о проделанной работе, и что планирую сделать на сегодня. Командой обсуждаем наработки.