165 лет со дня рождения русского учёного, писателя. Константина Эдуардовича Циолковского (1857-1935) День работника дошкольного образования. Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. В Кургане ожидается спад уровня воды в Тоболе до 30 см в течение 1-2 дней. 5-6 апреля 2024 года в Москве состоится 1-я Международная конференция технических писателей – TechWriter Days. Библиотекарь поселкового отделения познакомила воспитанников детского сада «Журавлик» с творчеством этого замечательного писателя.
Зачем нужны техписатели?
- Процессы и коммуникации в новой дистанционной реальности
- Текста больше, чем кода
- Новости Санкт-Петербурга - главные новости сегодня | ФОНТАНКА.ру - новости Санкт-Петербурга
- Солиста "Коррозии металла" оштрафовали за нацистскую символику
- Один день технического писателя: odin_moy_den — LiveJournal
TECHWRITER DAYS
Погода теплая, но мокрая: 6. Пора выходить на пробежку. Время: 7. Это стадион, на котором чудесное резиновое наверное покрытие, бегать одно удовольствие. Возможно сейчас пойдет дождь, но я сильная!
Я не пугаюсь 8. Срочно бегу в душ! Время: 10. Теперь можно полноценно позавтракать!
Овсяная каша, огурец, помидор, хлеб и чай - радость для моего организма 11. Кошка тоже считаешь, что давно пора опять есть и составляет мне приятную компанию: 12. Завтрак поглощен, посуда помыта, кошка довольна, время: 13. До выхода из дома осталось чуть меньше двух часов, надо срочно позаниматься за фортепиано, а погодка кстати налаживается, выглядывает солнышко.
Может быть, синоптики обманули нас с дождем? Позанималась вполне продуктивно, выучила 4 такта, которые никак не получались три дня подряд. Кошечка считает что ей тоже нужно заниматься, при чем срочно! Иначе кого-то покусают.
Она представила сборник «Сказки у костра», переизданный к столетию А. Митяева: Я приехала, чтобы передать вам привет из родных мест Анатолия Васильевича, из Рязанской области: он родился в посёлке Ястребки Сапожковского района. Анатолий Васильевич очень любил свою родину, приезжал несколько раз к нам в Рязань, видел свою школу, в которой учился. А мы, рязанцы, любим и помним Митяева, и как можем, сохраняем память о нем. В прошлом году, накануне столетия, благодаря Ие Николаевне Пестовой мы переиздали его «Сказки у костра». Эту книгу мы передаем в дар Российской государственной детской библиотеке. Подводя итог, Ольга Монина выразила благодарность всем, кто оказывал помощь и содействие в организации выставки: Мы благодарим Ию Николаевну Пестову за помощь в подготовке материалов к этой выставке, а также Георгия Махашвили и Василия Копейко — наследников художников — за возможность выставить работы их отцов в РГДБ.
Анжела Лебедева Художник-иллюстратор, доцент кафедры «Иллюстрация и эстамп» Института графики и искусства книги имени В.
Фаворского Московского Политеха Ольга Монина поделилась воспоминаниями из детства об Анатолии Митяеве: Мои детские и юношеские воспоминания о Митяеве укладываются в слово «улыбка». Он действительно улыбался везде, в том числе и на рабочем месте — в редакции журнала «Мурзилка». Для меня самый тёплый «Мурзилка» — это именно митяевский «Мурзилка». Анжела Лебедева и Ольга Монина Режиссёр-мультипликатор Леонид Носарев отметил вклад Анатолия Митяева в детскую литературу: В некотором смысле Анатолий Митяев определил мою творческую судьбу: благодаря ему в моей жизни произошли судьбоносные встречи, в том числе с замечательным писателем Юрием Ковалём. Эта замечательная выставка рассказывает нам о писателе и человеке, который понимает, чувствует, любит. Он оставил после себя творчество, которое необходимо, прежде всего, нашим детям.
Необходимо ли техническое задание на мобильное приложение? Каким может быть туториал в мобильном приложении? Что писать в справке к приложению? Будут ли пользователи читать сопроводительную документацию на сайте? Как организовать пополнение FAQ?
: техническим писателем ✒
Здесь вы отыщете наиболее значимые происшествия, новости Санкт-Петербурга, последние новости бизнеса, а также события в обществе, культуре, искусстве. Политика и власть, бизнес и недвижимость, дороги и автомобили, финансы и работа, город и развлечения — вот только некоторые из тем, которые освещает ведущее петербургское сетевое общественно-политическое издание.
Поделиться Текст как призвание Уже много лет я работаю техническим писателем в крупной IT-компании. До этого мне приходилось заниматься и тестированием, и программированием, и преподаванием, затем больше пяти лет отработал ведущим бизнес-аналитиком. Но я вернулся в писатели, и в этой статье я расскажу, почему.
В умных книгах по саморазвитию часто пишут, что заниматься любимым интересным делом — это один из главных способов избежать профессионального выгорания. Работе с системами и текстами я посвятил уже почти 25 лет, и могу с уверенностью сказать, что профессиональное выгорание — это не про меня. Моя специальность позволяет мне постоянно развиваться в разных направлениях, каждый день учиться чему-то новому, даже много лет проработав в одной компании. В мире разработки систем и ПО всё постоянно меняется — появляются новые технологии и отрасли, у систем появляются новые функциональные возможности.
Но всегда будут нужны те, кто сумеют во всём этом разобраться и написать простой понятный текст для пользователей системы. Я уверен, что в ближайшие десятилетия профессия технического писателя не только останется нужной и востребованной, но будет обретать всё большую популярность и ценность на рынке. Текста больше, чем кода — Кто за сутки до отправки заказчику во всей инструкции заменил manual на manul?! Давайте окинем взглядом весь процесс разработки программного обеспечения.
Его главный результат — это, конечно, программный код. А его главными действующими лицами всегда были и будут программисты, что бы там ни говорили другие его участники. Но сам этот процесс попутно порождает большое количество текстовых артефактов. Тут и функциональные требования заказчика, и техническое задание, и многочисленные протоколы совещаний, и переписки в чатах, и комментарии к запросам в системе планирования задач, и, наконец, описание реализации.
А ведь есть ещё многочисленные комментарии в коде, которые тоже содержат много нужной информации. В общем, текстов хватает. Так зачем же тогда в самом конце разработки нужен ещё и технический писатель? Почему всех этих документов недостаточно для того, чтобы дать ответы на основные вопросы заказчика и пользователя: как работает система и как её настроить?
Будем разбираться. Разработчики должны писать код, а не текст «Условие, что поле PART должно быть не пустым, обеспечивается целостностью процесса, заполняющего это поле, и не обеспечивается отдельным ограничением Oracle типа NOT NULL для обеспечения максимального быстродействия при изменении данных таблицы». Из внутренней документации проекта Бывает так, что программисты прекрасно разбираются в программе, досконально понимают все тонкости работы системы, но не могут красиво изложить всё это в текстовом виде. Лично я убеждён, что в этом нет ничего плохого.
Согласитесь, что даже текст, написанный с орфографическими и стилистическими ошибками, может быть понятным и успешно выполнять свою функцию — доносить до читателя мысль автора. А ошибки — это дело поправимое, коррекцию и правку текста при необходимости может выполнить редактор или тот же технический писатель. Главное — не допускать ошибок фактических.
Исследователи делают вывод: «Это показывает как важно для компаний иметь хорошо написанную документацию». Исследование 3 Nintex проводили исследование о самых неэффективных процессах в ИТ-компаниях. Я сама наблюдаю, что часто такая проблема бывает из-за того, что какие-то ошибки или процессы не описаны в документации. Источник В целом мы видим, что разработчики читают документацию, но большинство сталкивались с проблемой: её не было или она была неполной. Плохая документация — это неоправданно дорого для компаний.
Особенно, если она к продукту, которым пользуются многие. За последние четыре года не раз видела случаи, когда технический писатель переписывал инструкцию и экономил часы и дни разработчиков. Например, техписатель понятно переписал онбординг, который прошли 500 человек. Это заняло у них 3 дня, а не 5. Оставшиеся 8000 часов можно потратить на разработку фич или ещё что-то полезное для компании, ведь теперь им не надо писать вопросы в чат поддержки. Что должен знать и уметь технический писатель? Это тоже зависит от компании, продукта и существующих задач, но мы с вами обратимся к Хабр Карьере и посмотрим, что требует рынок. Есть почти во всех вакансиях в той или иной мере.
В любом случае знание ГОСТ сильно облегчает работу и дарит навык структурирования. Навыки сбора и анализа информации. Навыки сбора и анализа, а также описания требований — да, с требованиями техническим писателям приходится работать часто, и там есть серьёзные нюансы сбора, агрегации и «просеивания» собранной информации. Способность работать структурировать, перерабатывать с большими объёмами информации — и с каждым годом всё больше. Аккуратность, внимание к деталям. Умение писать легко и понятно — пользователи разные, и информация должна быть доступная каждому. Отличное знание русского языка. Знание английского языка — как значительное преимущество, а часто и строго обязательное требование.
Мария Смирнова О себе: деловой телеграм Есть расхожая фраза про то, что технические писатели — это «переводчики с разработческого на пользовательский». При всей её заезженности и радикальности я скорее склонна с этим тезисом согласиться. Не в последнюю очередь из-за того, что я сама не только технический писатель, но и переводчик. Перевод для меня — это упражнение, похожее на сборку конструктора или паззла, решение интеллектуальной задачки. Абсолютно то же самое я нашла и в техническом писательстве. Прелесть этой работы в том, что здесь можно применять творческий подход, оставаясь в чётко очерченных рамках и решая конкретную задачу.
Технические писатели смогут устроиться на работу в организацию, которая разрабатывает программные продукты, технику бытового характера, аппаратуру, предназначенную для медицины, научного мира. Личные способности и профессиональные качества Важнейшими личными способностями технического писателя являются технические и гуманитарные умственные способности, необходимо сочетать их в работе. Также важны спокойствие и внимание, заинтересованность в программировании, стремление обучаться и делиться с другими людьми своими открытиями.
К важнейшим профессиональным навыкам специалиста относятся умение четко и ясно излагать мысли в собственном тексте, знание технического английского языка, владение базовыми умениями программирования, графическими программами. Карьера Карьерного роста технический писатель может достигнуть, перейдя на работу в более крупную компанию, после того, как повысит свой профессионализм и наберется опыт, можно уйти в другую отрасль труда, стать техническим директором. Средняя заработная плата Средняя заработная плата по России технических писателей составляет от 40 до 90 тысяч рублей.
Работа технического писателя в IT-компании: цели, зоны роста, кому подходит
| Февральская встреча Сообщества технических писателей Санкт-Петербурга | 5-6 апреля в Москве состоится 1-я Международная конференция технических писателей TechWriter Days. |
| Технический писатель | CISOCLUB | Актуальные и свежие новости в стране и мире, эксклюзивные материалы и мнения экспертов. |
| День технического писателя | Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. |
| НОВОСТИ ДНЯ | Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. |
«День с писателем».
21 апреля в ГУНБ в отделе технической литературы (3 этаж, каб. 301) пройдет День технической книги. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области. Должность: технический писатель, хотя в последнее время скорее knowledge manager. Известный нижегородский писатель Валерий Шамшурин так сказал о нем. Историю празднования Дня писателя узнают те, кто придет в библиотеку №107 (Перовское шоссе, д. 16/2). Роль технического писателя Технический писатель переводит «от разработчика – клиенту».
Краткий обзорный ролик TechWriter Days - Первой Международной конференции технических писателей
Пожаловаться День технического писателя и сплошные двойки в сегодняшней дате натолкнули на мысль узнать у ребят получали ли они двойки в школе? Положила учебник на коленки :grin: Учитель заметил, конечно, и влепил двойку. А ещё один раз я написала сочинение по какому-то произведению и получила 2 за то, что поняла его не так, как учитель". Уже не помню, почему так случилось, помню только как мне было страшно и стыдно рассказывать об этом дома :scream: Когда приходила исправлять, учительница всё приговаривала: ну как же так, ты же умная девочка, неужели не вспомнила вот это правило?
В тот раз все обошлось, поскольку секунданты зарядили пистолеты клюквой вместо пуль.
У Льва Толстого был очень неразборчивый подчерк. Чтобы издатели смогли напечатать его произведения, жена и дочь вынуждены были переписывать рукописи. День писателя — праздник творческих людей и, как правило, проходит красиво и торжественно.
Конечно, при вычитке все ошибки найдутся и исправятся, но важно самостоятельно уметь превращать свои мысли в грамотные предложения. Техпис постоянно общается с разными людьми. С кем-то это легко и просто, а из кого-то информацию нужно добывать. Сложно представить на месте технического писателя интроверта, которого приводит в ужас мысль, что надо разговаривать. Например, заказчик говорит, что ему нужна документация.
У него есть макеты в «Фигме» и примерный флоу процесса. Выглядит так, будто для полноценной документации этого недостаточно. Но есть ещё хранитель знаний, которому, например, некогда эти знания превращать в текст. Тогда техпис собирает все возможные вопросы и идёт к хранителю выведывать информацию. Хранителем может быть любой человек из команды: разработчик, продакт, аналитик, юрист, дизайнер, кто угодно. Марина Вашак, технический писатель Умение писать коротко и по делу. Технический текст должен быть сухим, без лишних расшаркиваний. Техпис не гонится за количеством слов — наоборот, снимает с текста все «украшения»: обособленные обороты, составные глаголы, отглагольные существительные и прочую мишуру.
Адекватное восприятие критики. Работа технического писателя — процесс творческий, поэтому надо быть готовым к замечаниям. Они будут всегда, потому что даже самый крутой специалист — человек, а люди ошибаются. Если полагаться только на своё мнение, есть шанс написать инструкцию, которую сможет понять только автор. Адекватная обратная связь. В дополнение к предыдущему пункту: технический писатель — это не только писатель, но и читатель. У разработчиков есть код-ревью. У технических писателей, если их больше одного, в идеальном мире есть ревью текстов.
Потому что, опять же, все ошибаются, глаз замыливается, а две головы всегда лучше одной. И если нужно вычитать текст и дать обратную связь, понадобится много эмпатии и заинтересованности в общем результате, а не высокомерное «всё фигня, переделывай». Как понять, что работа мне подходит Возьмите приложение любимого банка и напишите инструкцию к какому-то простому процессу. Например, как оплатить мобильную связь. Покажите эту инструкцию друзьям или родителям, попросите проверить и попробовать пополнить баланс, следуя ей. Если инструкция сработала — поздравляю, это прекрасный старт, вы готовы к тестовым заданиям. Помониторьте вакансии для технических писателей без опыта и запросите тестовое задание.
В ИскраУралТел открыта вакансия Технического писателя В ИскраУралТел открыта вакансия Технического писателя Чем предстоит заниматься: - Коммуникации с заказчиком по защите и утверждению документации; - Разработка и утверждение документации по ГОСТ 19, 34; - Подготовка и согласование технических заданий; - Оформление требований. Теперь о вашем опыте и навыках, которые мы считаем ключевыми для вашей успешной работы.
Новости дня
Дневник писателя Ф. М. Достоевского. Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского. Известный нижегородский писатель Валерий Шамшурин так сказал о нем. за профессионализм, признание професии и чистоту русского языка (и в технических документах тоже)! В связи с отсутствием профессионального праздника у технических писателей предлагаю учредить его самостоятельно и ежегодно праздновать 17 сентября.
Конференции: полезный ресурс для технических писателей
Вы узнаете о том, как становятся техническими писателями, насколько путь техписателя тернист и интересен, почему документация важна. Специальность технический писатель появилась не так давно, однако уже является востребованной. О том, как устроена работа технического писателя в сфере заказной разработки, рассказывает Сергей Кузьмишкин, руководитель подразделения в компании Notamedia. День рождения Жириновского, второй сезон "Игры в кальмара" и первомай. 02:04. Технический писатель рассказывает о своём рабочем дне, объясняет, что это за профессия, какие инструменты применяются и какие навыки нужны.
Оклад: 25000-30000 руб.
System and application architects can learn how to create technical documentation to help them better describe architectural decisions and implementations. Developers can learn how to properly interact with technical writers to ensure better documentation creation. Testers can learn how to use technical documentation to create better test scenarios and test reports. Technical Support Engineers. 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.
На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними.
Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту. Наполнение документа текстами и отправка его на проверку экспертам. Внесение правок от разработчиков и экспертов.
Презентация документации заказчику. Передача документации команде. Этапы не должны затягиваться. Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану.
Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено. Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель.
Профессии технического писателя в российских вузах не учат. Есть курсы, где можно научиться писать технические тексты, но их немного. Поэтому осваивать такую профессию часто приходится по статьям в интернете, ориентируясь на примеры других. Это хорошая профессия для людей, желающих работать на стыке технического и гуманитарного направлений.
В отличие от копирайтинга, здесь меньше творчества и больше регламентов. Soft skills и Hard skills технического писателя в концепции Модели компетенций команды цифровой трансформации в системе государственного управления подробно описаны в Профиле роли. Технический писатель должен сочетать в себе свойства технаря и гуманитария. Интерес к технике и программированию, усидчивость и внимательность должны в нём сочетаться с желанием осваивать новое и делиться своими знаниями.
Очень важно знать предметную область, в которой ведется работа. Например, если вакансия открыта в ИТ-компании, потребуется знать языки программирования и разбираться в процессах разработки софта. Список ПО зависит от отрасли, в которой трудится специалист. Нужно уметь работать в команде, общаться с разработчиками и понимать пользователей, которые будут использовать продукт.
Часто работа идет в стандартных текстовых редакторах и программах для работы с изображениями. В некоторых IT-компаниях требуется, чтобы технический писатель знал языки разметки текста или один из языков программирования на уровне чтения кода, другим важны навыки работы с базами данных или в системах управления запросами. То, что пригодится точно — интерес к той сфере, о которой технический писатель работает. Некоторые работодатели требуют, чтобы образование у технического писателя было техническим.
Другим нужно просто высшее образование. Еще одно требование — знание иностранного языка, потому лингвисты, филологи, переводчики тоже востребованы. Хорошо пишут тексты и коммуникабельны, как правило, выпускники гуманитарных направлений: литераторы, журналисты. Если человеку с таким образованием понравится разбираться в новой для себя области, то, скорее всего, ему подойдет эта профессия.
Часто думают, что технический писатель — это профессия, не требующая особых коммуникативных навыков. На практике оказывается, что для написания документации каждый день приходится консультироваться со множеством коллег: бизнес-аналитиками, разработчиками, тестировщиками. Бывает так, что в исходных документах авторы что-то опускают, что-то недоговаривают. Работа технического писателя — быть профессиональным занудой: уточнять, переспрашивать, перепроверять информацию много раз, чтобы правильно всё описать и не допустить ошибку в документе.
Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений.
Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок. Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением. Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле.
Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно. Для того, чтобы достичь единства в этом вопросе, в компании должен существовать единый глоссарий терминов. Простой пример: один и тот же объект во внутренних документах может называться «системным параметром», «параметром системы», просто «параметром» или даже «записью в таблице параметров».
Программное обеспечение для онлайн-наблюдения, протоколирования и оценивания поведения пользователей при прохождении значимых онлайн-мероприятий экзаменов, тестирований Подробнее Ведущий разработчик технологий для корпоративного онлайн-обучения в секторе крупного и среднего бизнеса. Решения одобрены Минкомсвязи России и входят в единый реестр отечественного программного обеспечения.
Помогает автоматизировать адаптацию стажеров, обучать сотрудников дистанционно, проводить онлайн-тестирование и сертификацию, измерять эффективность обучения в реальном времени iSpring Suite Простой и мощный конструктор онлайн-курсов, видеолекций, тестов и еще 20 типов материалов обучающего контента. Websoft Разработчик программного обеспечения для автоматизации HR-процессов WebTutor Комплексная система управления обучением, оценкой и развитием персонала CourseLab Инструмент разработки электронных курсов любой сложности Виртуальный класс Система для проведения веб-семинаров Включает в себя пользовательский портал для централизованного хранения созданных документов, быстрого обновления всех форматов документации, поддержания в актуальном состоянии и обучения пользователей ИТ-системам и бизнес-процессам, а также сбора соответствующей аналитики и оценки знаний и уровня цифровой адаптации пользователей. Решение упрощает обучение сотрудников ИТ-системам и сокращает трудозатраты экспертов по разработке и актуализации пользовательской документации.
Наука и техника
Но при этом «живого» общения всё равно остаётся очень мало, поэтому сейчас мы решили сделать ещё один шаг навстречу коммуникациям. Итак, мы объявляем о создании площадки для общения и обмена опытом между техническими писателями! И называется она «Доквариум». Почему так? От «док» — документ и латинского суффикса «риум», что означает «дом», «место» как в «аквариум», «океанариум»…. То есть место для общения документаторов, которое со временем может стать нашим общим профессиональным «домом». По формату — это круглый стол в виде вебинара.
То есть, участвовать смогут, как обычно, все желающие, независимо от города и даже страны. Участие в наших встречах бесплатно. На первый раз у нас есть ограничение по количеству участников — 30 человек. Поскольку, по нашему опыту, мероприятие посещают не все зарегистрировавшиеся участники, мы примем больше заявок — в качестве эксперимента мы остановим регистрацию на 50 участниках.
Она посвящена 210-летию со дня рождения классика русской литературы, которое отметят в этом году 15 октября. Поэт неоднократно посещал азербайджанские земли, изучал азербайджанский язык, общался с местной интеллигенцией. К тому же он дружил с известным азербайджанским писателем, философом и общественным деятелем Мирзой Фатали Ахундовым. В экспозиции представлены интерьеры литературного салона времен первой половины XIX века, а также произведения скульптора Алекс андра Бурганова, пос вященные поэту. Вход по билетам. Для юных москвичей праздничные мероприятия, посвященные Дню писателя, пройдут в городских библиотеках. Вход для всех участников свободный, без предварительной регистрации. Чтобы не пропустить интересные и познавательные события 3 марта, за анонсами можно следить в разделе «Афиша» на портале mos. Кроме того, информация будет публиковаться на официальных сайтах библиотек. Культурный центр «Содружество» Рижский проезд, д. Юным гостям расскажут о жизни и творчестве Александра Пушкина и Корнея Чуковского. Всем гостям вместе с ведущими предстоит прочесть «Сказку о рыбаке и рыбке». В конце встречи ребят ждут познавательные игры. Им зададут вопросы по классическим и современным произведениям. Это поможет ребятам вспомнить знаменитые русские сказки, повести и рассказы. Здесь пройдет занятие «С книгой назначена встреча…». Детям расскажут интересные факты из жизни русских писателей Александра Пушкина, Ивана К рылова, Аркад ия Гайдара, чьи ю билейные даты пришлись на текущий год.
У технических писателей, если их больше одного, в идеальном мире есть ревью текстов. Потому что, опять же, все ошибаются, глаз замыливается, а две головы всегда лучше одной. И если нужно вычитать текст и дать обратную связь, понадобится много эмпатии и заинтересованности в общем результате, а не высокомерное «всё фигня, переделывай». Как понять, что работа мне подходит Возьмите приложение любимого банка и напишите инструкцию к какому-то простому процессу. Например, как оплатить мобильную связь. Покажите эту инструкцию друзьям или родителям, попросите проверить и попробовать пополнить баланс, следуя ей. Если инструкция сработала — поздравляю, это прекрасный старт, вы готовы к тестовым заданиям. Помониторьте вакансии для технических писателей без опыта и запросите тестовое задание. Вас попросят описать реальный кейс или подготовить простую инструкцию к бытовым действиям или вещам. Однажды мне дали задание: написать инструкцию к кошке. Пожалуй, это было самое милое тестовое. Я описывала кошку как самораспаковывающуюся систему. Подготовить платформу для установки и выбрать источник нужно заранее. Благодаря таким бытовым инструкциям можно оценить, как мыслит и пишет кандидат. А тестовые по реальным кейсам дадут представление о его умении разбираться в непонятных терминах и находить информацию. Марина Вашак, технический писатель Далеко не все компании дают обратную связь. Могут ограничиться кратким «к сожалению, мы выбрали другого кандидата». Будьте настойчивее и попросите разобрать ваше задание, расскажите, что вы только учитесь и очень хотите понять, куда двигаться дальше. Ещё есть чаты увлечённых техписательством людей. Можно проникнуть туда, чтобы посоветоваться, попросить вычитать текст или дать ОС. Там и вакансии периодически публикуют. Техническое писательство можно рассматривать как экспресс-курсы с очень быстрым погружением в различные темы. Описывая какой-то продукт, технический писатель узнаёт его устройство в деталях и достаточно близко знакомится с его владельцами. Поэтому не исключайте возможность, что очередной проект может привести вас к команде мечты и новая глава вашей карьеры начнётся с качественной документации. Часто в вакансиях для технических писателей пишут про рост до аналитика. Из-за этого у меня складывается впечатление, что техпис — работа временная, точка входа в айти, потом нужно в кого-то вырасти. Но никто не запретит быть техписом хоть всю жизнь, если вы любите тексты и вам интересно всегда писать о разном. Марина Вашак, технический писатель Как научиться писать понятные инструкции Много писать — дневники, посты в соцсетях, каналы в «Телеграме».
Может быть, после некоторого размышления, он догадается, что все эти названия описывают одно и то же. Но мы же любим наших пользователей, зачем постоянно заставлять их решать подобные головоломки? Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания. Так называются повторяющиеся фрагменты небольшого размера — словосочетания или короткие простые предложения. Например: «Функция … доступна в следующих режимах …» «Чтобы …, выполните в приложении … следующие действия: …» «Задайте системный параметр …» Для фигур описания иногда составляют отдельные словари или справочники. Казалось бы, мелочь. Но пользователь привыкает к определённым конструкциям и фразам. Если в одном месте документа написано «Выберите режим», а в другом «Перейдите в режим», у пользователя может возникнуть сомнения: здесь описано одно и то же действие или разные? Задача технического писателя — унифицировать весь тот зоопарк формулировок и терминов, которые употребляют в своих документах аналитики, разработчики и другие участники процесса разработки ПО. У технических писателей обычно есть свои словари терминов и фигур описания. Опытный писатель разбирается в системе и понимает, что именно означает тот или иной жаргонный термин во внутреннем документе. Вратарь разработки Технический писатель — лучший гуманитарий среди технарей и лучший технарь среди гуманитариев. Михаил Острогорский Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. Это тот самый рубеж, на котором «баг» то есть «изъян» волшебным образом превращается в «фичу», а «велосипеды» и «подпорки» — в стройную архитектурную схему из красивых разноцветных прямоугольников. Как известно, программист — это не тот, кто пишет программы, а тот, чьи программы работают. Точно так же технический писатель — это не тот, кто пишет технические тексты, а тот, чьи документы помогают пользователю решить проблему или найти ответ на вопрос. Раньше разработку пользовательской и эксплуатационной документации могли взвалить на программистов, хотя это совсем не их обязанность. За написание документации могли посадить и специалиста с гуманитарным образованием, который в совершенстве владеет родным или иностранным языком, но при этом обычно совершенно не разбирается в предмете описания. Обычно при таком подходе, хороший итоговый результат мог получиться разве что случайно. Теперь в каждой достаточно крупной компании по производству ПО есть свои технические писатели, которые одновременно хорошо умеют разбираться в сложных технических системах и писать понятные тексты на нужном языке. Спрос на хорошую, качественную документацию к программам и системам постоянно растёт. При этом, по моим наблюдениям, сейчас на рынке наблюдается недостаток профессиональных технических писателей. Мы как раз находимся в активном поиске новых писателей в нашу команду и ощущаем этот дефицит в полной мере — опытные технические писатели сейчас на вес золота. Во всём мире профессия technical writer или technical author считается престижной и перспективной. Спрос на технических писателей обычно превышает предложение. Многие переходят в технические писатели из других профессий — переводчиков, аналитиков, даже программистов.