165 лет со дня рождения русского учёного, писателя. Константина Эдуардовича Циолковского (1857-1935) День работника дошкольного образования. Служба безопасности День. Табло. Глобалисты провоцируют жёсткие санкции. Кастинг, вакансия для ДРУГОЕ: (Удаленка) Требуется технический писатель.
Кто такие технические писатели и зачем они нужны в команде
Технические писатели. Поэтому какое-то время мечтала стать писателем. День рождения Жириновского, второй сезон "Игры в кальмара" и первомай. 02:04.
НОВОСТИ ДНЯ
Когда и где: 14 — 16 апреля, Портленд, США. Это событие соберет вместе профессионалов различных направлений в индустрии разработки: backend, frontend и fullstack-разработчиков, тестировщиков и QA-специалистов, web-дизайнеров и проектировщиков интерфейсов, системных аналитиков, тимлидов, техлидов и менеджеров разработки. Участникам будет предоставлена возможность рассказать о своей компании, продуктах и новых проектах. Техническим писателям также будет интересно присоединиться! Когда и где: 26 апреля, Екатеринбург, РФ. Будучи самой старой организацией в данной области, STC предоставляет широкие возможности для общения и обучения у коллег, интенсивные сессии по ключевым темам и обновлениям в отрасли.
Это мероприятие способствует постоянному развитию знаний, навыков и общения для профессионалов в области технической коммуникации. Более подробную информацию о программе саммита можно найти на сайте STC. Когда и где: 17-19 мая, Миннеаполис, США. Июнь Каждый год специалисты по технической коммуникации, включая разработчиков информации, технических писателей, технических редакторов и переводчиков, собираются на мероприятии Evolution of TC, которое фокусируется на новых разработках в области документации программного обеспечения. Данное мероприятие является единственной техкомм конференцией в Юго-Восточной Европе.
Для получения более подробной информации обращайтесь на сайт конференции. Когда и где: 4-5 июня, София, Болгария. Knowledge Conf 2024 Программа конференции Knowledge Conf охватывает широкий спектр аспектов управления знаниями. В ее рамках рассматриваются как прикладные задачи, включающие в себя обучение новичков, организацию базы знаний, создание внутренних университетов, а также практическое обучение, так и фундаментальные аспекты, такие как применение современных методов обучения и развитие системного мышления.
Салтыкова-Щедрина технический день переносится с последней среды месяца на вторник 22 февраля. В этот день библиотека будет закрыта для посещений: в ней будет происходить обеспыливание книг и помещений, вестись другие санитарные работы. Также напоминаем, что 23 февраля библиотека не работает в связи с официальным праздником — Днем защитника Отечества.
Также важны спокойствие и внимание, заинтересованность в программировании, стремление обучаться и делиться с другими людьми своими открытиями.
К важнейшим профессиональным навыкам специалиста относятся умение четко и ясно излагать мысли в собственном тексте, знание технического английского языка, владение базовыми умениями программирования, графическими программами. Карьера Карьерного роста технический писатель может достигнуть, перейдя на работу в более крупную компанию, после того, как повысит свой профессионализм и наберется опыт, можно уйти в другую отрасль труда, стать техническим директором. Средняя заработная плата Средняя заработная плата по России технических писателей составляет от 40 до 90 тысяч рублей. Однако такая сумма условна, всё зависит от масштабности фирмы, стажа, профессиональных навыков сотрудника. О нас Образовательный портал TimeStudent для абитуриентов и студентов.
Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания. Так называются повторяющиеся фрагменты небольшого размера — словосочетания или короткие простые предложения. Например: «Функция … доступна в следующих режимах …» «Чтобы …, выполните в приложении … следующие действия: …» «Задайте системный параметр …» Для фигур описания иногда составляют отдельные словари или справочники. Казалось бы, мелочь.
Но пользователь привыкает к определённым конструкциям и фразам. Если в одном месте документа написано «Выберите режим», а в другом «Перейдите в режим», у пользователя может возникнуть сомнения: здесь описано одно и то же действие или разные? Задача технического писателя — унифицировать весь тот зоопарк формулировок и терминов, которые употребляют в своих документах аналитики, разработчики и другие участники процесса разработки ПО. У технических писателей обычно есть свои словари терминов и фигур описания. Опытный писатель разбирается в системе и понимает, что именно означает тот или иной жаргонный термин во внутреннем документе. Вратарь разработки Технический писатель — лучший гуманитарий среди технарей и лучший технарь среди гуманитариев. Михаил Острогорский Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. Это тот самый рубеж, на котором «баг» то есть «изъян» волшебным образом превращается в «фичу», а «велосипеды» и «подпорки» — в стройную архитектурную схему из красивых разноцветных прямоугольников. Как известно, программист — это не тот, кто пишет программы, а тот, чьи программы работают.
Точно так же технический писатель — это не тот, кто пишет технические тексты, а тот, чьи документы помогают пользователю решить проблему или найти ответ на вопрос. Раньше разработку пользовательской и эксплуатационной документации могли взвалить на программистов, хотя это совсем не их обязанность. За написание документации могли посадить и специалиста с гуманитарным образованием, который в совершенстве владеет родным или иностранным языком, но при этом обычно совершенно не разбирается в предмете описания. Обычно при таком подходе, хороший итоговый результат мог получиться разве что случайно. Теперь в каждой достаточно крупной компании по производству ПО есть свои технические писатели, которые одновременно хорошо умеют разбираться в сложных технических системах и писать понятные тексты на нужном языке. Спрос на хорошую, качественную документацию к программам и системам постоянно растёт. При этом, по моим наблюдениям, сейчас на рынке наблюдается недостаток профессиональных технических писателей. Мы как раз находимся в активном поиске новых писателей в нашу команду и ощущаем этот дефицит в полной мере — опытные технические писатели сейчас на вес золота. Во всём мире профессия technical writer или technical author считается престижной и перспективной.
Спрос на технических писателей обычно превышает предложение. Многие переходят в технические писатели из других профессий — переводчиков, аналитиков, даже программистов. У нас интереснее! Техническое документирование — это одна из замечательных пограничных областей для тех, кто так и не смог смириться в школе с разделением на гуманитариев и математиков.
Конференции: полезный ресурс для технических писателей
Project Managers. Project managers can learn how to organize and optimize the processes of creating and managing technical documentation to improve project quality. Product Managers. Product managers can gain insight into how effective technical documentation can improve customer and user perception of the product.
Suppliers of Tools and Technologies. Companies that provide tools and technologies for creating and managing technical documentation can use the conference to promote their products and connect with potential customers. Why should I participate?
Communication Two days of intensive work with colleagues, you will be able to discover new solutions to the challenges facing you and your company. Experience You can familiarize yourself with best practices and personally discuss the details that interest you with independent experts and representatives of leading IT companies. Networking Informal interactions will provide you with information about the effectiveness and feasibility of specific solutions your company plans to use.
Discussions Participating in roundtable discussions and debates will enable you to view aspects of technical documentation from different perspectives, uncovering new possibilities for effective work. Contacts New connections will help you tap into the vast experience of top experts in the field of technical documentation.
Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания. Так называются повторяющиеся фрагменты небольшого размера — словосочетания или короткие простые предложения. Например: «Функция … доступна в следующих режимах …» «Чтобы …, выполните в приложении … следующие действия: …» «Задайте системный параметр …» Для фигур описания иногда составляют отдельные словари или справочники. Казалось бы, мелочь.
Но пользователь привыкает к определённым конструкциям и фразам. Если в одном месте документа написано «Выберите режим», а в другом «Перейдите в режим», у пользователя может возникнуть сомнения: здесь описано одно и то же действие или разные? Задача технического писателя — унифицировать весь тот зоопарк формулировок и терминов, которые употребляют в своих документах аналитики, разработчики и другие участники процесса разработки ПО. У технических писателей обычно есть свои словари терминов и фигур описания. Опытный писатель разбирается в системе и понимает, что именно означает тот или иной жаргонный термин во внутреннем документе. Вратарь разработки Технический писатель — лучший гуманитарий среди технарей и лучший технарь среди гуманитариев.
Михаил Острогорский Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. Это тот самый рубеж, на котором «баг» то есть «изъян» волшебным образом превращается в «фичу», а «велосипеды» и «подпорки» — в стройную архитектурную схему из красивых разноцветных прямоугольников. Как известно, программист — это не тот, кто пишет программы, а тот, чьи программы работают. Точно так же технический писатель — это не тот, кто пишет технические тексты, а тот, чьи документы помогают пользователю решить проблему или найти ответ на вопрос. Раньше разработку пользовательской и эксплуатационной документации могли взвалить на программистов, хотя это совсем не их обязанность. За написание документации могли посадить и специалиста с гуманитарным образованием, который в совершенстве владеет родным или иностранным языком, но при этом обычно совершенно не разбирается в предмете описания.
Обычно при таком подходе, хороший итоговый результат мог получиться разве что случайно. Теперь в каждой достаточно крупной компании по производству ПО есть свои технические писатели, которые одновременно хорошо умеют разбираться в сложных технических системах и писать понятные тексты на нужном языке. Спрос на хорошую, качественную документацию к программам и системам постоянно растёт. При этом, по моим наблюдениям, сейчас на рынке наблюдается недостаток профессиональных технических писателей. Мы как раз находимся в активном поиске новых писателей в нашу команду и ощущаем этот дефицит в полной мере — опытные технические писатели сейчас на вес золота. Во всём мире профессия technical writer или technical author считается престижной и перспективной.
Спрос на технических писателей обычно превышает предложение. Многие переходят в технические писатели из других профессий — переводчиков, аналитиков, даже программистов. У нас интереснее! Техническое документирование — это одна из замечательных пограничных областей для тех, кто так и не смог смириться в школе с разделением на гуманитариев и математиков.
И здесь тоже никак без чувства юмора? Я сам делаю запросы, какие функции надо проверить в устройстве, и они снимают для меня смешные видосы. Это часть рабочего процесса, когда в обычной обстановке люди находятся, переговариваются друг с другом и между делом снимают видео. И люди выражают свои эмоции, если что-то выходит не так, в своем же инженерском стиле — это может быть нецензурное выражение, очень часто, даже через каждое слово, — смеется технический писатель. Молодой человек пояснил, что традиция смешных видео в компании сложилась достаточно давно — с момента первого обмена видео с китайскими коллегами.
Правда, с медведями и русской айдентикой ему не присылают. Они китайцам еще очень давно начали снимать смешные видосы: ставили на фоне плюшевого медведя, бутылку водки, игрушечную балалайку и на английском снимали видосы, ну такой троллинг. То есть уже давно наработан такой опыт. Сколько получает технический писатель Зарплата технического писателя в Москве в среднем сейчас составляет от 80 000 до 120 000 рублей. Молодой человек рассказал, что у него она до вычета налогов сейчас — 110 тысяч рублей, он работает удаленно. Эта профессия непростая, подчас монотонная и рутинная. Самое главное для техписа — умение рассказывать о сложных вещах простым и легким языком. Поэтому начинающему автору в первую очередь важно научиться понятно излагать техническую информацию. В учебных заведениях технических писателей не готовят.
Начать карьеру техрайтера можно, получив высшее техническое образование. В идеале это человек с грамотным русским языком и математическим мышлением одновременно. Я на технического писателя не учился вообще. Выставили вакансию по другой специальности, но в сфере, где работал раньше. Мое резюме нашел замдиректора компании и предложил сделать тестовое. Я его отлично выполнил, и меня пригласили на работу, — объяснил наш герой.
Покажут, как использовать разные стихотворные размеры и рифмы, применять игру слов. Часть беседы посвятят феномену авторского вдохновения и тому, как оно влияет на литературный труд и его результат. Для участия необходимо купить билет на экскурсию, а также отдельно приобрести билет на постоянную экспозицию музея «Слово». В этот же день в 19:00 в музее «Слово» состоится еще одна писательская экскурсия. На ней речь пойдет о создателях древних книг — монахах-переписчиках. Они не только сохраняли и тиражировали духовные и летописные знания, но и сыграли важную роль в появлении авторских сочинений. Помимо этого, экскурсанты узнают о том, какие сообщения писали друг другу люди на берестяных грамотах. Затем они познакомятся с первыми произведениями русских путешественников, которые назывались хождениями. А еще гостям покажут уникальный памятник русской литературы XVII века — «Житие протопопа Аввакума, им самим написанное». Протопоп Аввакум положил начало такому жанру, как автобиография. Например, гости узнают, как возникло русское стихосложение и почему Александр Пушкин до сих пор считается главным русским поэтом. Посещение экскурсии и музея бесплатное. Любители русской литературы 3 марта могут посетить выставку «Лев Толстой. Гости ВДНХ пог рузятся в атмосферу первой половины XIX века и в интерактивном формате познакомятся с творчеством великого русского писателя. Экспозиция состоит из 13 тематических разделов. Каждый из них посвящен определенному эпизоду романа-эпопеи «Война и мир». При помощи мультимедийных технологий посетители смогут разучить танцевальные движения, повторяя их за парой на экране, или поиграть в старые карточные игры, а после этого проследить за ходом Бородинского сражения.
«День с писателем».
| 366. День технической книги | В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского. |
| #Кем стать: Техническим писателем | SQA ANALYST TECHWRITER DAYSСмотреть онлайн - Краткий обзорный ролик TechWriter Days - Первой Международной конференции технических писателей. |
| История профессии технического писателя | С целью напоминания о роли писательства в мире был учреждён Всемирный День писателя, который отмечается ежегодно 3 марта. |
: техническим писателем ✒
Требования: - Опыт подготовки технической документации ГОСТ 19, ГОСТ 34 ; - Хороший уровень владения русским языком, грамотная письменная речь; - Умение структурировать и систематизировать информацию; - Уверенное владение пакетом офисных приложений Word, Excel ; - Базовое понимание процессов разработки программного обеспечения. Контактные телефоны:.
Приходите рассказывать и спрашивать, говорить и спорить, а не только слушать! Если вы подготовите презентацию, присылайте файл до начала встречи, и мы сможем оперативно подгрузить его в вебинар. Планы на будущее Также просим вас подумать, чего бы вы хотели от таких встреч — пишите свои предложения нам на адрес info protext. Также можете присылать любые идеи по поводу встреч, мы рассмотрим их все! Обратите внимание, в форме регистрации есть два важных поля: вопросы для обсуждения на этом Доквариуме и темы следующих.
Пишите, что вас интересует, о чём вы хотите поговорить, и мы отберём вопросы, по которым будет максимальное количество запросов, и вынесем их на ближайшее обсуждение. Будьте активны, интересность и полезность встречи зависит только от вас! Для регистрации заполните форму ниже. За день до Доквариума мы вышлем ссылку для подключения. Регистрация на Доквариум.
Маркетинг IT О компании: Многопрофильная группа компаний, осуществляющих деятельность в сфере информационных технологий. Ключевые направления деятельности: системная интеграция, производство телекоммуникационного оборудования и ПО, разработка системы автоматического распознавания лиц и научно-исследовательская деятельность.
Я могу писать фантастические рассказы, могу писать про нечисть, какую-то там, русалок, домовых, но это основная тема, которая для меня и болезненна и свята, это мой родной город». Во многом тексты Олега Рябова автобиографичны — в них есть близкие ему люди и места.
Так и новый роман автора — "Позови меня, Ветлуга" о зове Родины, на который откликаются герои — пусть даже неосознанно. Так, по мнению Олега Рябова, хороший писатель должен, в первую очередь, писать. Во-вторых, писать надо правдиво.
Военная операция на Украине
Взаимодействие с дизайнерами нужно для того, чтобы задокументировать те или иные решения по дизайну. Руководители проектов. С РП технический писатель взаимодействует для координации и контроля над соблюдением всех необходимых формальностей со стороны участников проекта. Обеспечивает консистентность формальной части проекта. Цели работы технического писателя Работа в сфере заказной разработки — это командный вид спорта, поэтому цель работы технического писателя — это успех всей команды, всего проекта. Антицель — написать красивый документ по ГОСТу, по которому невозможно провести испытания демонстрацию продукта заказчику , либо который не коррелируется с разработанной функциональностью продукта. Поэтому технический писатель разрабатывает документацию для целей, которые должны совпадать с целями компании. Если он пишет отчетную документацию по конкретному проекту, то он должен тесно взаимодействовать с проектной командой и осознавать, что разработанная функциональность будет приниматься заказчиком именно на основе написанной им отчетной документации. А ошибки в отчетной документации приводят к провалу испытаний или вовсе к отказу в приемке работ.
Для технического писателя важно не зацикливаться на самом тексте, а смотреть в суть. Прийти к разработчику и спросить: «Все ли я правильно понял и написал? Еще один важный момент — технический писатель должен не только предоставить заказчику комплект отчетной документации, но и согласовать ее с ним. Если клиенту что-то не нравится — выяснить, что именно, и понять, как это исправить. Куда расти техническому писателю Представим ситуацию, что человек приходит на позицию технического писателя, перерастает грейд Junior и в какой-то момент начинает думать: «А куда дальше развиваться? Буду ли я до конца карьеры писать технические документы, такие как руководство пользователя? У технического писателя есть конкретные зоны роста — как горизонтального, так и вертикального. Поговорим о горизонтальном росте подробнее.
Хороший технический писатель должен знать, какие шаги нужно пройти для успешной сдачи проекта. Это шаги, которые находятся не только в его компетенции, но и которые должны пройти другие участники команды: дизайнеры — нарисовать макеты, разработчики — написать код, аналитики — описать бизнес-процессы. И контроль выполнения работ другими участниками команды тоже может быть в числе обязанностей техписа. Также техпис должен уметь оценивать затраты на разработку той или иной документации: Сначала сформулировать требования к другим участникам команды — в каком виде и в какие сроки ему должны предоставить исходные данные для формирования комплекта отчетной документации. С учетом качества и количества исходных данных прикинуть свои трудозатраты на формирование отчетной документации. Уложить это все на план-график исполнения контракта, понять, сколько нужно людей, какой трек согласования документации, и как вообще при этом выжить. То есть это процессное и ресурсное управление, которым он должен владеть. И это схожие процессы с теми, которые есть у руководителя проекта.
Что из этого следует: техпис может быть правой или левой рукой руководителя проекта и, соответственно, в этом направлении развиваться. Так что хороший техпис может вырасти до РП. Иногда это классическая аналитика при ведении проектов, когда сначала есть общие верхнеуровневые требования, а затем надо проговорить с заказчиком, что сделать — декомпозировать эти требования, провести трассировку, управлять ими. Бывают и неклассические аспекты аналитики. Например, мы берем проект, которым ранее занимался другой подрядчик. И теперь нам надо его развивать. Стартовая задача технического писателя — это разобраться в этом проекте, провести Reverse engineering технической части проекта: что написано, как это работает.
Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация. Процесс работы технического писателя. Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего. Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать. Вот как строится процесс работы: Определение главных задач документации и ее аудиторию. Составление плана технической документации и согласование его с заказчиком. Здесь скорее всего, будут изменения, поэтому важнее понять какие вопросы хочет решить заказчик. Изучение как работает программа или устройство. На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними. Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту. Наполнение документа текстами и отправка его на проверку экспертам. Внесение правок от разработчиков и экспертов. Презентация документации заказчику. Передача документации команде. Этапы не должны затягиваться. Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану. Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено. Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель. Профессии технического писателя в российских вузах не учат. Есть курсы, где можно научиться писать технические тексты, но их немного. Поэтому осваивать такую профессию часто приходится по статьям в интернете, ориентируясь на примеры других. Это хорошая профессия для людей, желающих работать на стыке технического и гуманитарного направлений. В отличие от копирайтинга, здесь меньше творчества и больше регламентов. Soft skills и Hard skills технического писателя в концепции Модели компетенций команды цифровой трансформации в системе государственного управления подробно описаны в Профиле роли. Технический писатель должен сочетать в себе свойства технаря и гуманитария. Интерес к технике и программированию, усидчивость и внимательность должны в нём сочетаться с желанием осваивать новое и делиться своими знаниями. Очень важно знать предметную область, в которой ведется работа. Например, если вакансия открыта в ИТ-компании, потребуется знать языки программирования и разбираться в процессах разработки софта. Список ПО зависит от отрасли, в которой трудится специалист. Нужно уметь работать в команде, общаться с разработчиками и понимать пользователей, которые будут использовать продукт. Часто работа идет в стандартных текстовых редакторах и программах для работы с изображениями. В некоторых IT-компаниях требуется, чтобы технический писатель знал языки разметки текста или один из языков программирования на уровне чтения кода, другим важны навыки работы с базами данных или в системах управления запросами.
Также можно ознакомиться с первой публикацией повести «Веселый солдат» в журнале «Новый мир» 1998 г. Город Чусовой — литературная родина Виктора Астафьева. Он жил здесь в 1945-1962 гг. В разделе «Чусовские затеси» представлена книга «По следам "Веселого солдата"» Владимира Маслянки, в которой большая часть материала посвящена журналисту Астафьеву. В разделе «Вологодские затеси» рассказывается о жизни писателя в Вологде, его работе над «Затесями» и романом «Царь-рыба», который принес Виктору Астафьеву всесоюзную известность. В 1978 г. Раздел «Красноярские затеси» посвящен заключительному периоду творчества драматурга. В 1980 г. В это время он писал как художественную прозу, так и публицистику.
Требования: - Опыт подготовки технической документации ГОСТ 19, ГОСТ 34 ; - Хороший уровень владения русским языком, грамотная письменная речь; - Умение структурировать и систематизировать информацию; - Уверенное владение пакетом офисных приложений Word, Excel ; - Базовое понимание процессов разработки программного обеспечения. Контактные телефоны:.
Зачем нужны технические писатели
Возможно, нам удастся сделать этот день официальным Днём технического писателя в Беларуси. найм технических директоров, что бизнес ждёт от человека на позиции директора и какими глазами смотрит на соискателя. Рассказываем о профессии технического писателя: обязанности, задачи, навыки, которые пригодятся для работы.
Газета.Ру в соцсетях
Увы, подавляющему большинству технических писателей приходится «вариться в собственном соку» и решать все свои вопросы самостоятельно. Служба безопасности День. Табло. Глобалисты провоцируют жёсткие санкции. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области. В Новом здании Российской национальной библиотеки (Московский пр., д.165 к.2) начала работу выставка «Затеси» Виктора Астафьева», приуроченная к 100-летнему юбилею русского писателя и драматурга. Опыт работы в качестве технического писателя в области разработки и внедрения информационных систем от 3х лет. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области.
День технического писателя
Вторая часть Дня технического творчества проходила на базе СПДС «Иволга», где участники трансляции посетили Хобби-клуб для родителей «Успех». Меня зовут Елена, мне 23 года, я живу в Москве, работаю техническим писателем. Представляю свой будний день 10 июля 2012 года. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области.
История профессии технического писателя
Политика и власть, бизнес и недвижимость, дороги и автомобили, финансы и работа, город и развлечения — вот только некоторые из тем, которые освещает ведущее петербургское сетевое общественно-политическое издание. Санкт-Петербург читает «Фонтанку»!
Communication Two days of intensive work with colleagues, you will be able to discover new solutions to the challenges facing you and your company. Experience You can familiarize yourself with best practices and personally discuss the details that interest you with independent experts and representatives of leading IT companies. Networking Informal interactions will provide you with information about the effectiveness and feasibility of specific solutions your company plans to use. Discussions Participating in roundtable discussions and debates will enable you to view aspects of technical documentation from different perspectives, uncovering new possibilities for effective work. Contacts New connections will help you tap into the vast experience of top experts in the field of technical documentation. Learning A unique opportunity for learning and participation in workshops will allow you to enhance the quality of your work. Change of Environment Working in a new setting will enable you to look at technical documentation development issues in a fresh light and make the most efficient use of your time for company development. WiFi High-speed internet will allow you to perform real-time production tasks, even while attending presentations.
For your convenience, a template letter for your management justifying your participation in the conference is provided below. Gaining New Knowledge and Best Practices. 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.
Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении. Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано. Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца.
Только так получится хорошая и качественная документация. Один в поле не воин Часто думают, что технический писатель — это профессия, не требующая особых коммуникативных навыков. На практике оказывается, что для написания документации каждый день приходится консультироваться со множеством коллег: бизнес-аналитиками, разработчиками, тестировщиками. Бывает так, что в исходных документах авторы что-то опускают, что-то недоговаривают. Работа писателя — быть профессиональным занудой: уточнять, переспрашивать, перепроверять информацию много раз, чтобы правильно всё описать и не допустить ошибку в документе. Бывают случаи, когда писатели находят ошибки в реализации. Писатель выполняет свою работу на самом последнем рубеже перед отгрузкой системы и документации заказчику.
На поверку становись! Когда писатель завершает работу над документом, он обязательно отправляет его на проверку. Документацию проверяют бизнес-аналитики, разработчики, тестировщики. Это очень важный этап, ведь писатель всегда может ошибиться — что-то неправильно понять, не учесть каких-то незадокументированных особенностей реализации. Ещё наши документы проверяет наш профессиональный технический редактор. Он исправляет орфографические и грамматические ошибки, подчищает описки, следит за смысловой и логической чистотой документа, проверяет соблюдение руководства по стилю. Это руководство — наш маленький внутренний стандарт.
В нём записаны разрешённые и запрещённые термины, правила оформления документов разных типов, приведены наиболее часто используемые фразы, конструкции и обороты. Руководство по стилю помогает нам писать документацию по общим для всех писателей правилам: единство стиля — прежде всего. В воображении читателя должен возникнуть собирательный образ одного крутого профессионала — писателя, который создаёт разные документы или разделы. Праздник труда Работа технического писателя не такая однообразная, как может показаться со стороны. Мы пишем очень разные документы — у нас есть и справочники с большими таблицами параметров или полей БД. Есть руководства пользователя с подробным описанием каждой кнопки интерфейса. Есть руководства администратора со множеством технических подробностей о работе и установке системы.
Но самый сложный, и при этом самый интересный, тип документа — это руководство по настройке. В нём комплексно описывается реализация определённого решения в разных системах и подробно объясняется что и где нужно настроить, чтобы это решение заработало. Писателю приходится писать разные типы документов — сегодня часами описывать один за другим параметры системы, а завтра думать над тем, как понятнее и проще описать алгоритм работы решения в руководстве по настройке. Но в любом случае писатель должен быть внимательным, аккуратным и педантичным. Клиент всегда прав — отгрузка до 23. Документы на систему мы отгружаем одновременно с передачей готовой системы. Новые версии ранее отгруженных документов мы, по сложившейся традиции, передаём в пятницу.
Документацию мы пока отгружаем в формате PDF — вместе с новой версией системы заказчик получает пакет файлов.
В таких текстах важно, чтобы информация была структурированной, чтобы в них были списки, таблицы, схемы. Часто именно небольшой список помогает пользователю быстрее, чем длинное описание на двадцати страницах. В технических текстах обычно много иллюстраций, скриншотов интерфейсов, видео. Это нужно, чтобы человек сравнил картинку на инструкции с тем, что видит на мониторе, понял, что действует правильно, и настроил систему по шагам на картинках «В моей работе главное ориентироваться на конечного потребителя: как с помощью технической документации он будет решать свои задачи, какой у него уровень подготовки и насколько подробно все должно быть заложено в инструкции. К примеру, я сейчас работаю над частью внутренней информационной системой, которой будут пользоваться технические специалисты.
Поэтому основные требования — подробная и длинная инструкция с множеством скриншотов и примеров, которые позволят пользователю решить разные задачи. А в другом проекте я пишу небольшую часть документации по функциональности продукта для обычных пользователей. Здесь тексты простые, информативные и доступные. Моя основная задача — сделать так, чтобы и системный администратор, и обычный пользователь нашли в инструкции то что ищут и этот поиск не занял много ресурсов». Приступая к написанию любой инструкции, технический писатель анализирует многочисленные источники информации и преобразует полученные оттуда данные в пользовательскую документацию. Самый главный источник — это технический проект ТП , которые пишут бизнес-аналитики ещё до начала разработки.
Технический проект — это закон для разработчиков, тестировщиков и технических писателей. В идеале всё должно быть реализовано именно так, как написано в ТП. На деле же оказывается, что итоговая реализация отличается от ТП: что-то не учли, что-то поняли неправильно, что-то оптимизировали. Для того, чтобы узнать, как на самом деле всё было реализовано, используется техническое описание ТО , которое пишут разработчики. Там есть больше технических подробностей, описаны изменения конкретных типов данных и таблиц в БД, приведены алгоритмы работы процедур серверного кода, приведены скриншоты добавленных или изменённых окон в клиентских приложениях. Есть ещё один важный источник — описание настроек интеграционного тестирования.
Там подробно описаны все настройки, которые нужно сделать в системах, чтобы пройти все тестовые сценарии тест-кейсы. Этот источник незаменим для написания руководств по настройке. Технический проект, техническое описание и описание настроек — это основные источники, из которых писатель получает информацию. Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах. Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении.
Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано. Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация. Процесс работы технического писателя. Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего.
Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать. Вот как строится процесс работы: Определение главных задач документации и ее аудиторию. Составление плана технической документации и согласование его с заказчиком. Здесь скорее всего, будут изменения, поэтому важнее понять какие вопросы хочет решить заказчик. Изучение как работает программа или устройство. На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними.
Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту.
ВДНХ и городские библиотеки приглашают 3 марта на День писателя
TechWriter Days прошла 5-6 апреля 2024 в енция организована с целью собрать и объединить специалистов, занимающихся технической документацией. Мы ищем технического писателя в команду Indeed Access Manager. Технический писатель рассказывает о своём рабочем дне, объясняет, что это за профессия, какие инструменты применяются и какие навыки нужны. Специальность технический писатель появилась не так давно, однако уже является востребованной.