Последние события в режиме онлайн: главные новости российского бизнеса и политики, международные события, криминальные происшествия, обзоры прессы, движения фондового рынка, лента спортивных новостей, автомобильные новости. Коллеги, наступил февраль, а с ним и День технического писателя — 2 февраля. Свежие новости Москвы на сегодня и завтра. Какое метро откроют, какими будут «Лужники». Последние новости на официальном сайте Мэра Москвы.
Конференции: полезный ресурс для технических писателей
«Приходится переводить с инженерского на русский»: как работают и сколько получают технические писатели в Москве. Возможно, нам удастся сделать этот день официальным Днём технического писателя в Беларуси. «Приходится переводить с инженерского на русский»: как работают и сколько получают технические писатели в Москве. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области.
Профессия технический писатель: чем занимается и как проходит типичный рабочий день
Срочно бегу в душ! Время: 10. Теперь можно полноценно позавтракать! Овсяная каша, огурец, помидор, хлеб и чай - радость для моего организма 11. Кошка тоже считаешь, что давно пора опять есть и составляет мне приятную компанию: 12.
Завтрак поглощен, посуда помыта, кошка довольна, время: 13. До выхода из дома осталось чуть меньше двух часов, надо срочно позаниматься за фортепиано, а погодка кстати налаживается, выглядывает солнышко. Может быть, синоптики обманули нас с дождем? Позанималась вполне продуктивно, выучила 4 такта, которые никак не получались три дня подряд.
Кошечка считает что ей тоже нужно заниматься, при чем срочно! Иначе кого-то покусают. Гимнастика с красной ленточкой: 15. После утомительных упражнений, я желаю кошке хорошенько выспаться и отдохнуть, она мне тоже желает не перетрудиться: 16.
Пора выходить на работу. Время: 17. На бегу включаю плеер, самое время послушать Рахманинова! Выхожу из подъезда, а дорогу мне перебегает черный котейка.
Вакансия перемещена в архив Вероятно, эта вакансия закрыта. Но у нас есть много других похожих вакансий, которые могут Вас заинтересовать. Показать описание вакансии Обязанности: Разработка сетевых графиков проектов, конструкторской и эксплуатационной документации, схем, маршрутных карт и другой технической документации, внесение изменений в техническую документацию в связи с корректировкой; Разработка конструкторской и эксплуатационной документации; Ведение переписки с заказчиком и исполнителями составной части опытно-конструкторской работы, документооборот; контроль сроков выполнения работ по договорам; участие в ведении архива документации учёт, регистрация, выдача, копирование, актуализация ; участие в совещаниях по направлениям разработки и сопровождения инфраструктуры; Отчётность по договорной работе.
Это полезно, так как РП тяжело погружаться в эти юридические тонкости. И здесь задача технического писателя — прикрывать РП по формальной части. Вертикальный рост технического писателя Вертикальный рост технического писателя прост и понятен. В подразделении Nota. Docs четко выстроена градация между специалистами уровня Junior, Middle и Senior: Junior — новичок, обладающий базовыми компетенциями: грамотность, владение MS Office, системность и структурированность мышления, внимательность к деталям.
Но ему нужна помощь от более опытных коллег по ряду вопросов. Middle — это человек с опытом, который работает самостоятельно. Если ему поставили задачу, он не прибегает к помощи других коллег-техписов. Это не означает, что он не имеет права задавать вопросы другим участникам проектной команды. Но значит то, что за ним не надо проверять. Он знает, как добыть информацию, к кому пойти по тому или иному вопросу и знает срок, к которому все должно быть сделано, а также в каком объеме и качестве. Senior — это уже расширенные компетенции и нечто большее, чем все функциональные обязанности специалиста Middle. Это «большее» может быть с точки зрения, например, управленца — то есть человек, который ставит задачи нескольким мидлам.
Или человек, который глубоко знает определенную предметную область или систему. Поэтому специалист может вырасти до ведущего технического писателя, в подчинении которого находится несколько специалистов, затем — в руководителя подразделения технической документации. Кому подходит карьера технического писателя Главное качество, которое отличает технического писателя — это ответственность. Потому что мы работаем с формальным треком, который с крупным заказчиком проходит через его внутренний электронный документооборот, сопроводительные бумаги и письма. Поэтому невозможно физически договориться о том, что мы сегодня не успели и сделаем завтра. Если срок сдачи документа — 30 сентября, то не позднее этого дня он должен быть любой ценой. Но при этом вариативность типа личности, которому подходит карьера технического писателя, велика. Есть люди, которые целый день проводят в переговорах, обсуждении договоренностей и планов.
А есть те, кто сидит и разбирается в функциональности продукта, выясняет, что за полгода сделали разработчики. Именно от специфики проекта зависит тот склад ума и характера человека, который под него подходит. Предположим, в компании открыто несколько вакансий технических писателей на разные проекты. Давайте смоделируем несколько ситуаций: проектов и подходящих под них типажей кандидатов. Типаж 1 — «библиотечный бука» Есть проект А, на котором приходится писать сложные документы. Например, пояснительную записку на 1000 страниц с техническими подробностями. Человек, который подходит под этот проект, может быть не очень коммуникабельным, но должен быть своеобразным «библиотечным букой»: зарыться в техническую информацию и сидеть с ней разбираться, выстраивая из этого стройный текст. Типаж 2 — «решала» Проект Б.
На проекте много согласующих, но несложная документация. Не требуется глубоко лезть в технические вещи. На этом проекте, чтобы согласовать небольшую стопку документов, нужно встретиться с заказчиками и с 5-6 людьми договориться, понять, что они хотят, найти к каждому подход.
А ошибки — это дело поправимое, коррекцию и правку текста при необходимости может выполнить редактор или тот же технический писатель. Главное — не допускать ошибок фактических. Каждый должен заниматься своим делом. Например, математику или физику часто проще написать формулу, чем объяснить словами какой-то закон. Программисту проще выражать свои мысли в виде кода и алгоритмических конструкций. Когда же дело доходит до формулирования чётких и понятных текстов на русском или другом языке, в дело вступает технический писатель. Это тот самый специалист, который переводит информацию с языка разработчиков на язык пользователей.
Не было бы технических писателей, и программистам пришлось бы самим напрягаться, пытаясь объяснить такие понятные и очевидные для них вещи обычным пользователям системы. Стройная система подпорок и противовесов Хогвартс напоминает любой IT-проект, который разрабатывается долгое время. Древние баги, нигде не прописанные фичи, несовместимости, куча сдерживающих этот ужас костылей и несколько программистов, которые даже не хотят лезть в неведомые глубины и гордо называют их «школьными традициями». Мы уже привыкли и считаем нормальным, что у наших программ есть много недокументированных возможностей. Если система живёт и развивается уже несколько лет, то в ней с каждым годом появляется всё больше исключений из правил. В неё добавляются новые функциональные возможности, старые отмирают или видоизменяются. Настройка системы становится всё сложнее, в интерфейсе появляется всё больше параметров, которые взаимодействуют друг с другом неочевидным и зачастую непредсказуемым образом. Постоянная гонка за быстрой реализацией новых бизнес-возможностей приводит к тому, что сокращается время на рефакторинг старого кода и устаревших интерфейсов. Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели.
Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши».
Первый «Доквариум» пройдёт 28 июля
- (Удаленка) Требуется технический писатель.
- Технический писатель
- Рекомендации
- Газета.Ру - последние новости, свежие события сегодня - Новости
Зачем техписам конференции?
- День рождения инженера и писателя-фантаста
- Первый «Доквариум» пройдёт 28 июля
- Физик и лирик. Технический писатель: Новые тенденции и требования в документации '23
- Главные новости
- Газета.Ру - последние новости, свежие события сегодня - Новости
Конференции для технических писателей в 2024
- Зачем нужны техписатели?
- Зачем нужны техписатели?
- Новости Самары - главные новости сегодня | 63.ру - новости Самары
- Один день из жизни технического писателя. Среда.
- В ИскраУралТел открыта вакансия Технического писателя
День технического специалиста на PulpFor 2023
В рамках конференции будут рассмотрены методики разработки документации, проектная документация, создание баз знаний, инструменты технического писателя и многое другое. Особый интерес представляет тот факт, что организаторами этого мероприятия являются те же люди, которые организуют такие успешные конференции, как SQA Days и Analyst Days. Кроме того, Документерра является серебряным партнером конференции и выступит с докладом о мировых тенденциях в области документации. Приглашаем вас присоединиться к нам, чтобы послушать выступление нашего технического директора и принять участие в обсуждении. Будем рады видеть вас на мероприятии! Когда и где: 5 — 6 апреля, Москва, РФ. Write the Docs 12-я ежегодная конференция Write the Docs в Портленде приглашает участников технического сообщества поделиться своими идеями и знаниями. Изначально мероприятие проводилось для разработчиков, но теперь оно включает всех, кто проявляет интерес к документации.
Конференция нацелена на объединение специалистов по документации для обмена опытом, укрепления профессиональных связей, приобретения новых навыков, вдохновения и приятного времяпрепровождения. Дополнительную информацию можно получить на сайте конференции. Когда и где: 14 — 16 апреля, Портленд, США. Это событие соберет вместе профессионалов различных направлений в индустрии разработки: backend, frontend и fullstack-разработчиков, тестировщиков и QA-специалистов, web-дизайнеров и проектировщиков интерфейсов, системных аналитиков, тимлидов, техлидов и менеджеров разработки. Участникам будет предоставлена возможность рассказать о своей компании, продуктах и новых проектах. Техническим писателям также будет интересно присоединиться! Когда и где: 26 апреля, Екатеринбург, РФ.
Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели. Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано.
Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений. Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок. Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением.
Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно.
Санкт-Петербург читает «Фонтанку»! Наша аудитория — лидеры бизнеса и политики, чиновники, десятки тысяч горожан.
В ИскраУралТел открыта вакансия Технического писателя В ИскраУралТел открыта вакансия Технического писателя Чем предстоит заниматься: - Коммуникации с заказчиком по защите и утверждению документации; - Разработка и утверждение документации по ГОСТ 19, 34; - Подготовка и согласование технических заданий; - Оформление требований. Теперь о вашем опыте и навыках, которые мы считаем ключевыми для вашей успешной работы.
НОВОСТИ ДНЯ
5-6 апреля 2024 года в Москве состоится 1-я Международная конференция технических писателей «TechWriter Days». Главной целью для технического писателя является объяснить пользователю, как обращаться с приборами или компьютерными программами доступным и понятным языком. Историю празднования Дня писателя узнают те, кто придет в библиотеку №107 (Перовское шоссе, д. 16/2). за профессионализм, признание професии и чистоту русского языка (и в технических документах тоже)!
День из жизни технического писателя в Алматы с зарплатой около 440 000 ₽
21 апреля в ГУНБ в отделе технической литературы (3 этаж, каб. 301) пройдет День технической книги. Рассказываем о профессии технического писателя: обязанности, задачи, навыки, которые пригодятся для работы. Увы, подавляющему большинству технических писателей приходится «вариться в собственном соку» и решать все свои вопросы самостоятельно.
Презентация "Профессия Технический писатель" для студентов НИУ ВШЭ (27.10.2020)
Интерес представляет уникальное издание «Игарские затеси» Валентины Гапеенко. В нем можно найти первую публикацию о литературном творчестве школьника Виктора Астафьева в газете «Большевик Заполярья» 1939 г. Представлено одно из первых произведений писателя «Васюткино озеро». Автор книги также приводит переписку Астафьева с игарчанами. Основная часть фотоматериалов взята из фондов писателя и Красноярского краевого краеведческого музея.
Особое место в творчестве Виктора Астафьева занимала Великая Отечественная война. На фронт он пошел добровольцем, служил шофером, артиллеристом, разведчиком, связистом, пока в 1944 г. В раздел «Солдатские затеси» вошли произведения на военную тему, написанные автором по своим воспоминаниям: «Прокляты и убиты», «Где-то гремит война», «Пастух и пастушка». Также можно ознакомиться с первой публикацией повести «Веселый солдат» в журнале «Новый мир» 1998 г.
Иногда это классическая аналитика при ведении проектов, когда сначала есть общие верхнеуровневые требования, а затем надо проговорить с заказчиком, что сделать — декомпозировать эти требования, провести трассировку, управлять ими. Бывают и неклассические аспекты аналитики. Например, мы берем проект, которым ранее занимался другой подрядчик. И теперь нам надо его развивать. Стартовая задача технического писателя — это разобраться в этом проекте, провести Reverse engineering технической части проекта: что написано, как это работает. Вторая задача — посмотреть на документы, какие были договоры и технические задания. И понять, что реально представляет собой проект или конкретный продукт, и соотнести с тем, что написано в документах. То есть это Reverse engineering с прицелом на формальную часть. Сергей Кузьмишкин, руководитель подразделения Nota. Docs Нетипичный случай аналитики также возникает, когда нужно обосновать заказчику стоимость работ в ходе формальных процедур по подготовке к конкурсу.
И тут надо понять детали реализации — сходить к разработчикам, понять, что они реализовали, и каким образом эта функциональность работает. Если разработчики еще не реализовали, то идти к продактам, которые развивают данную часть продукта, и узнавать, что они задумывали и сделали. Все это нужно оформить и защитить перед заказчиком, иногда вплоть до демонстрации кода продукта. Поэтому технический писатель может вырасти в аналитика. В крупных контрактах, как коммерческих, так и государственных, есть правила привлечения генподрядчиком субподрядчиков: на какие работы их можно привлечь, на какие нет, на какие работы нужно привлечь обязательно. Типичный пример — если на проекте выполняются работы по информационной безопасности, то они требуют наличия лицензий, которых у генподрядчика может не быть. Если привлечь субподрядчика, не выполняя обязательные шаги по контракту, то генподрядчик не сдаст проект. То есть эта зона роста — на стыке IT и юриспруденции. У нас в Notamedia есть кейс с сотрудником, который ранее работал на стороне заказчика и занимался проверкой формальной стороны договоров. Типичный подводный камень в договоре — исполнитель должен уведомить заказчика за 5 дней до проведения испытаний о том, что он к ним готов.
И если он этого не сделал — начинаются проблемы. И этот сотрудник обладает способностью быстро вычитывать договоры, сразу подмечая места в документе, где могут возникнуть проблемы. Это полезно, так как РП тяжело погружаться в эти юридические тонкости. И здесь задача технического писателя — прикрывать РП по формальной части. Вертикальный рост технического писателя Вертикальный рост технического писателя прост и понятен. В подразделении Nota. Docs четко выстроена градация между специалистами уровня Junior, Middle и Senior: Junior — новичок, обладающий базовыми компетенциями: грамотность, владение MS Office, системность и структурированность мышления, внимательность к деталям. Но ему нужна помощь от более опытных коллег по ряду вопросов. Middle — это человек с опытом, который работает самостоятельно. Если ему поставили задачу, он не прибегает к помощи других коллег-техписов.
Это не означает, что он не имеет права задавать вопросы другим участникам проектной команды. Но значит то, что за ним не надо проверять.
В данной картине впервые был использован альбомный метод мультипликации. В 1924-1925 годах художник занимался рисованием рекламных киноплакатов для таких фильмов, как «Девушка в маске», «Куртизанка», «Жена фараона» и многие другие. Достаточно известен плакат Сутеева к ленте «Веселые ребята» , который он создавал вместе с Дмитрием Бабиченко. В 1928-м году мужчина начал работать на кинофабрике «Межрабломфильм».
Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации.
Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений. Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»!
Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок. Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением. Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно. Для того, чтобы достичь единства в этом вопросе, в компании должен существовать единый глоссарий терминов. Простой пример: один и тот же объект во внутренних документах может называться «системным параметром», «параметром системы», просто «параметром» или даже «записью в таблице параметров».
Для разработчиков системы может быть понятно, что всё это — один и тот же объект. Для пользователя же это совсем не так очевидно.
Один день технического писателя
| : техническим писателем ✒ | Станислав, вы описали самый отличный день технического писателя. |
| газета ЗАВТРА : Блоги | Конференция для технических писателей – это событие, организованное с целью собрать и объединить специалистов, занимающихся технической документацией. |
Новости дня
Поэтому какое-то время мечтала стать писателем. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области. Полчаса смеялся, когда некая hbnf назначила (в философтовском форуме) 1 апреля Днем технического писателя. Заканчивается рабочий день технического писателя тем же, чем и начинался — синхронизацией с SVN.