День рождения инженера и писателя-фантаста 01.03.1981 Писатель-фантаст Александр Казанцев.
Газета.Ру в соцсетях
Например, для пользователя нужно писать «простым» языком, давать подробный порядок действий, для разработчика, напротив, нужны четкие формулировки с терминами, описание рабочих примеров кода. Вам сложно понять, что нужно писать, с чего начинать, как писать? Не переживайте. Для каждого типа описываемого объекта, например, справочник, сценарий или установка, имеется отдельный формат описания. Формат задает структуру описаний, предоставляет готовые типовые фразы, правила оформления текста. Проще говоря, формат — это шаблон для новых текстов. Мы пишем не поэмы, не повести, требующие творческой окраски, мы пишем техническую документацию, которая должна быть простой, структурированной и понятной любому. Запускаю программу и поочередно описываю каждую ее вкладку: «Основное окно», «Настройки». Обязательно добавляю назначение программы и общие разделы, например, «Способы запуска».
Структуру текста я как раз беру из готового формата описания. Если возникают вопросы, ответы на которые не удалось найти ни в технических проектах, ни в интернете, можно напрямую обратиться с вопросами к разработчику. Бояться тут нечего. Каждый сотрудник компании дружелюбно ответит вам либо перенаправит к человеку, который более компетентен в поставленном вопросе. Не забывайте, мы же одна команда! В перерывах между описаниями наступает обед. Время на работе течет в быстром темпе, не успеешь и заметить, как утро кончится. Насытившись и отдохнув, с полными силами возвращаемся и погружаемся в поток рабочего процесса.
Согласитесь, что даже текст, написанный с орфографическими и стилистическими ошибками, может быть понятным и успешно выполнять свою функцию — доносить до читателя мысль автора. А ошибки — это дело поправимое, коррекцию и правку текста при необходимости может выполнить редактор или тот же технический писатель. Главное — не допускать ошибок фактических. Каждый должен заниматься своим делом. Например, математику или физику часто проще написать формулу, чем объяснить словами какой-то закон. Программисту проще выражать свои мысли в виде кода и алгоритмических конструкций.
Когда же дело доходит до формулирования чётких и понятных текстов на русском или другом языке, в дело вступает технический писатель. Это тот самый специалист, который переводит информацию с языка разработчиков на язык пользователей. Не было бы технических писателей, и программистам пришлось бы самим напрягаться, пытаясь объяснить такие понятные и очевидные для них вещи обычным пользователям системы. Стройная система подпорок и противовесов Хогвартс напоминает любой IT-проект, который разрабатывается долгое время. Древние баги, нигде не прописанные фичи, несовместимости, куча сдерживающих этот ужас костылей и несколько программистов, которые даже не хотят лезть в неведомые глубины и гордо называют их «школьными традициями». Мы уже привыкли и считаем нормальным, что у наших программ есть много недокументированных возможностей.
Если система живёт и развивается уже несколько лет, то в ней с каждым годом появляется всё больше исключений из правил. В неё добавляются новые функциональные возможности, старые отмирают или видоизменяются. Настройка системы становится всё сложнее, в интерфейсе появляется всё больше параметров, которые взаимодействуют друг с другом неочевидным и зачастую непредсказуемым образом. Постоянная гонка за быстрой реализацией новых бизнес-возможностей приводит к тому, что сокращается время на рефакторинг старого кода и устаревших интерфейсов. Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели.
Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации.
Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано.
С 1984 года журнал поменял своё название на «Хроника наших дней» изменились заставка и музыка журнала. В ряде городов СССР, например, в Минске, были созданы специальные кинотеатры «Новости дня» для демонстрации выпусков одноименного киножурнала.
В экспозиции представлены интерьеры литературного салона времен первой половины XIX века, а также произведения скульптора Алекс андра Бурганова, пос вященные поэту. Вход по билетам. Для юных москвичей праздничные мероприятия, посвященные Дню писателя, пройдут в городских библиотеках. Вход для всех участников свободный, без предварительной регистрации.
Чтобы не пропустить интересные и познавательные события 3 марта, за анонсами можно следить в разделе «Афиша» на портале mos. Кроме того, информация будет публиковаться на официальных сайтах библиотек. Культурный центр «Содружество» Рижский проезд, д. Юным гостям расскажут о жизни и творчестве Александра Пушкина и Корнея Чуковского. Всем гостям вместе с ведущими предстоит прочесть «Сказку о рыбаке и рыбке». В конце встречи ребят ждут познавательные игры. Им зададут вопросы по классическим и современным произведениям. Это поможет ребятам вспомнить знаменитые русские сказки, повести и рассказы. Здесь пройдет занятие «С книгой назначена встреча…».
Детям расскажут интересные факты из жизни русских писателей Александра Пушкина, Ивана К рылова, Аркад ия Гайдара, чьи ю билейные даты пришлись на текущий год. А еще библиотекари помогут гостям найти ответы на вопросы о том, кто такие писатели и в чем состоит их труд. Еще для ребят проведут конкурсы, в которых они смогут проявить свою эрудицию, начитанность и смекалку. Начало в 11:00.
Оклад: 25000-30000 руб.
25 апреля 2024 года в Большом выставочном зале Российской государственной детской библиотеки открылась выставка иллюстраций «С красной строки» к 100-летию со дня рождения писателя Анатолия Васильевича Митяева. Киножурнал "Новости дня" выходил с 1944 по 1983 годы. Последние события в режиме онлайн: главные новости российского бизнеса и политики, международные события, криминальные происшествия, обзоры прессы, движения фондового рынка, лента спортивных новостей, автомобильные новости. С вами опять Татьяна, переводчик и технический писатель из Торонто. Мои предыдущие посты в сообществе можно увидеть здесь.
Один день из жизни технического писателя. Среда.
Один или два параграфа о том, почему вы самый крутой писатель технических новостей в блоке. Самые свежие новости России и мира, новости политики, шоу-бизнеса. С вами опять Татьяна, переводчик и технический писатель из Торонто. Мои предыдущие посты в сообществе можно увидеть здесь. Вы узнаете о том, как становятся техническими писателями, насколько путь техписателя тернист и интересен, почему документация важна.
TECHWRITER DAYS
Каждый из них посвящен определенному эпизоду романа-эпопеи «Война и мир». При помощи мультимедийных технологий посетители смогут разучить танцевальные движения, повторяя их за парой на экране, или поиграть в старые карточные игры, а после этого проследить за ходом Бородинского сражения. В павильоне открыто арт-пространство, где можно посмотреть фильмы о жизни и творчестве Льва Толстого, а также принять участие в литературном вечере и даже создать мультфильм по мотивам произведения. Вход на постоянную выставку свободный.
Она работает с 11:00 до 19:00 ежедневно, кроме понедельника. Великий поэт в культуре Азербайджана». Она посвящена 210-летию со дня рождения классика русской литературы, которое отметят в этом году 15 октября.
Поэт неоднократно посещал азербайджанские земли, изучал азербайджанский язык, общался с местной интеллигенцией. К тому же он дружил с известным азербайджанским писателем, философом и общественным деятелем Мирзой Фатали Ахундовым. В экспозиции представлены интерьеры литературного салона времен первой половины XIX века, а также произведения скульптора Алекс андра Бурганова, пос вященные поэту.
Вход по билетам. Для юных москвичей праздничные мероприятия, посвященные Дню писателя, пройдут в городских библиотеках. Вход для всех участников свободный, без предварительной регистрации.
Чтобы не пропустить интересные и познавательные события 3 марта, за анонсами можно следить в разделе «Афиша» на портале mos. Кроме того, информация будет публиковаться на официальных сайтах библиотек. Культурный центр «Содружество» Рижский проезд, д.
Юным гостям расскажут о жизни и творчестве Александра Пушкина и Корнея Чуковского.
Техническая документация позволяет пользователям быстрее понимать и эффективно использовать функциональность продукта. С кем взаимодействует технический писатель Над разработкой продукта в IT-компании работает проектная команда. И для подготовки документации технический писатель взаимодействует со всеми ее участниками: Разработчики. Технический писатель переводит понятные и прописные истины программиста на удобный для пользователя язык. Для этого он идет к разработчику и задает вопросы о том, как работает система. Для оплаты услуг субподрядчика или оплаты услуг компании нужны сопутствующие документы. Технический писатель вместе с финансовым отделом участвует в разработке этих документов для заказчика и их приемке от субподрядчика. С ними технический писатель обсуждает логику создания продукта, которую те придумали для разработчиков. Иногда совместно с аналитиками технический писатель может создавать документацию для команды разработки.
Взаимодействие с дизайнерами нужно для того, чтобы задокументировать те или иные решения по дизайну. Руководители проектов. С РП технический писатель взаимодействует для координации и контроля над соблюдением всех необходимых формальностей со стороны участников проекта. Обеспечивает консистентность формальной части проекта. Цели работы технического писателя Работа в сфере заказной разработки — это командный вид спорта, поэтому цель работы технического писателя — это успех всей команды, всего проекта. Антицель — написать красивый документ по ГОСТу, по которому невозможно провести испытания демонстрацию продукта заказчику , либо который не коррелируется с разработанной функциональностью продукта. Поэтому технический писатель разрабатывает документацию для целей, которые должны совпадать с целями компании. Если он пишет отчетную документацию по конкретному проекту, то он должен тесно взаимодействовать с проектной командой и осознавать, что разработанная функциональность будет приниматься заказчиком именно на основе написанной им отчетной документации. А ошибки в отчетной документации приводят к провалу испытаний или вовсе к отказу в приемке работ. Для технического писателя важно не зацикливаться на самом тексте, а смотреть в суть.
Прийти к разработчику и спросить: «Все ли я правильно понял и написал? Еще один важный момент — технический писатель должен не только предоставить заказчику комплект отчетной документации, но и согласовать ее с ним. Если клиенту что-то не нравится — выяснить, что именно, и понять, как это исправить. Куда расти техническому писателю Представим ситуацию, что человек приходит на позицию технического писателя, перерастает грейд Junior и в какой-то момент начинает думать: «А куда дальше развиваться? Буду ли я до конца карьеры писать технические документы, такие как руководство пользователя? У технического писателя есть конкретные зоны роста — как горизонтального, так и вертикального. Поговорим о горизонтальном росте подробнее. Хороший технический писатель должен знать, какие шаги нужно пройти для успешной сдачи проекта. Это шаги, которые находятся не только в его компетенции, но и которые должны пройти другие участники команды: дизайнеры — нарисовать макеты, разработчики — написать код, аналитики — описать бизнес-процессы. И контроль выполнения работ другими участниками команды тоже может быть в числе обязанностей техписа.
Также техпис должен уметь оценивать затраты на разработку той или иной документации: Сначала сформулировать требования к другим участникам команды — в каком виде и в какие сроки ему должны предоставить исходные данные для формирования комплекта отчетной документации. С учетом качества и количества исходных данных прикинуть свои трудозатраты на формирование отчетной документации. Уложить это все на план-график исполнения контракта, понять, сколько нужно людей, какой трек согласования документации, и как вообще при этом выжить.
Презентация документации заказчику.
Передача документации команде. Этапы не должны затягиваться. Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану. Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено.
Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель. Профессии технического писателя в российских вузах не учат.
Есть курсы, где можно научиться писать технические тексты, но их немного. Поэтому осваивать такую профессию часто приходится по статьям в интернете, ориентируясь на примеры других. Это хорошая профессия для людей, желающих работать на стыке технического и гуманитарного направлений. В отличие от копирайтинга, здесь меньше творчества и больше регламентов.
Soft skills и Hard skills технического писателя в концепции Модели компетенций команды цифровой трансформации в системе государственного управления подробно описаны в Профиле роли. Технический писатель должен сочетать в себе свойства технаря и гуманитария. Интерес к технике и программированию, усидчивость и внимательность должны в нём сочетаться с желанием осваивать новое и делиться своими знаниями. Очень важно знать предметную область, в которой ведется работа.
Например, если вакансия открыта в ИТ-компании, потребуется знать языки программирования и разбираться в процессах разработки софта. Список ПО зависит от отрасли, в которой трудится специалист. Нужно уметь работать в команде, общаться с разработчиками и понимать пользователей, которые будут использовать продукт. Часто работа идет в стандартных текстовых редакторах и программах для работы с изображениями.
В некоторых IT-компаниях требуется, чтобы технический писатель знал языки разметки текста или один из языков программирования на уровне чтения кода, другим важны навыки работы с базами данных или в системах управления запросами. То, что пригодится точно — интерес к той сфере, о которой технический писатель работает. Некоторые работодатели требуют, чтобы образование у технического писателя было техническим. Другим нужно просто высшее образование.
Еще одно требование — знание иностранного языка, потому лингвисты, филологи, переводчики тоже востребованы. Хорошо пишут тексты и коммуникабельны, как правило, выпускники гуманитарных направлений: литераторы, журналисты. Если человеку с таким образованием понравится разбираться в новой для себя области, то, скорее всего, ему подойдет эта профессия. Часто думают, что технический писатель — это профессия, не требующая особых коммуникативных навыков.
На практике оказывается, что для написания документации каждый день приходится консультироваться со множеством коллег: бизнес-аналитиками, разработчиками, тестировщиками. Бывает так, что в исходных документах авторы что-то опускают, что-то недоговаривают. Работа технического писателя — быть профессиональным занудой: уточнять, переспрашивать, перепроверять информацию много раз, чтобы правильно всё описать и не допустить ошибку в документе. Бывают случаи, когда писатели находят ошибки в реализации.
Кому нужен технический писатель. Если проект небольшой, то возможно, технический писатель совсем не нужно. Но есть огромные преимущества, когда в проекте есть технический писатель. Технические писатели четким языком излагаю информацию.
Она посвящена 210-летию со дня рождения классика русской литературы, которое отметят в этом году 15 октября. Поэт неоднократно посещал азербайджанские земли, изучал азербайджанский язык, общался с местной интеллигенцией. К тому же он дружил с известным азербайджанским писателем, философом и общественным деятелем Мирзой Фатали Ахундовым. В экспозиции представлены интерьеры литературного салона времен первой половины XIX века, а также произведения скульптора Алекс андра Бурганова, пос вященные поэту. Вход по билетам. Для юных москвичей праздничные мероприятия, посвященные Дню писателя, пройдут в городских библиотеках. Вход для всех участников свободный, без предварительной регистрации. Чтобы не пропустить интересные и познавательные события 3 марта, за анонсами можно следить в разделе «Афиша» на портале mos. Кроме того, информация будет публиковаться на официальных сайтах библиотек.
Культурный центр «Содружество» Рижский проезд, д. Юным гостям расскажут о жизни и творчестве Александра Пушкина и Корнея Чуковского. Всем гостям вместе с ведущими предстоит прочесть «Сказку о рыбаке и рыбке». В конце встречи ребят ждут познавательные игры. Им зададут вопросы по классическим и современным произведениям. Это поможет ребятам вспомнить знаменитые русские сказки, повести и рассказы. Здесь пройдет занятие «С книгой назначена встреча…». Детям расскажут интересные факты из жизни русских писателей Александра Пушкина, Ивана К рылова, Аркад ия Гайдара, чьи ю билейные даты пришлись на текущий год.
О мероприятии
- АНОНС: TechWriter Days – Международная конференция технических писателей
- День из жизни технического писателя. |
- Сузунская централизованная библиотечная система | Новости
- #Кем стать: Техническим писателем
- АНОНС: TechWriter Days – Международная конференция технических писателей
- Февральская встреча Сообщества технических писателей Санкт-Петербурга
Зачем нужны технические писатели
Заканчивается рабочий день технического писателя тем же, чем и начинался — синхронизацией с SVN. Один или два параграфа о том, почему вы самый крутой писатель технических новостей в блоке. Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. Доклад Марии Макеевой на конференции AnalystDays #17 27-28 октября 2023. г. Москва Россия
Подробности
- Telegram: Contact @technicalwriters
- Работа технического писателя в IT-компании: цели, зоны роста, кому подходит — Карьера на
- Зачем нужны технические писатели
- Технический писатель
- Открылась выставка «С красной строки» к 100-летию со дня рождения писателя Анатолия Митяева
Открылась выставка «С красной строки» к 100-летию со дня рождения писателя Анатолия Митяева
З марта отмечается Всемирный день писателя03.03.2022 18:33 — ННТВ (видео). Коллеги, наступил февраль, а с ним и День технического писателя — 2 февраля. Всемирный день писателя отмечается не только литераторами, но и редакторами, корректорами, критиками, культурологами, журналистами и другими людьми, чья работа связана со словом. Служба безопасности День. Табло. Глобалисты провоцируют жёсткие санкции. США после подписания законопроекта о военной помощи смогут начать снабжение украинской армии боеприпасами и вооружением с американских складов в Германии всего за несколько дней. Жителей Молдавии призвали праздновать День Европы вместо Дня Победы.