День технического перевода. Степан ЖуринГазета «Лицейский вестник» и «Лицейское телевидение»15 октября 2019.
Все новости
Смотрите онлайн самые последние и важные новости канала ОТР на официальном сайте. Главная задача технического писателя – четко и понятно донести до пользователя информацию в виде инструкции об особенностях работы программы, ее основных функциях, проблемах, которые могут возникнуть. Конференции для технических писателей играют важную роль в профессиональном развитии и успехе в этой области. 5-6 апреля 2024 года в Москве состоится 1-я Международная конференция технических писателей «TechWriter Days». Конференция для технических писателей – это событие, организованное с целью собрать и объединить специалистов, занимающихся технической документацией. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского.
Кто такие технические писатели и зачем они нужны в команде
Интересные факты Русский ПЕН-центр возник в 1989 году. Его штаб-квартира находится в Москве. Президент РФ В. Путин объявил 2015-й год в России Годом литературы. Первым лауреатом Нобелевской премии по литературе стал в 1901 году французский поэт и эссеист Сюлли-Прюдом.
В 2015 году ее лауреатом стала советская и белорусская писательница, журналистка Светлана Алексиевич. Дублинская литературная премия — наиболее престижная литературная премия в мире. Ее размер — 100 тысяч евро. Она вручается ежегодно с 1996 года за лучшее прозаическое произведение на английском языке.
У читателя, не знакомого с нашей профессией, может сразу возникнуть вопрос: что же писатели хранят в SVN, ведь это не программисты, исходников у них нет. В том-то и дело, что есть. Об этом нужно рассказать подробнее. Это формат, основанный на XML, который позволяет сохранять исходный текст документов в структурированном виде. Затем из этих исходников мы можем собрать итоговый документ в любом нужном формате.
Наш Toolkit позволяет собирать документы во множестве форматов. При желании мы можем собрать даже EPUB, если заказчик вдруг захочет почитать нашу документацию перед сном на электронной книге. По необходимости мы вносим правки в XSLT-преобразования, чтобы изменить правила сборки документов и их внешний вид. Подробнее о формате Формат DITA вообще оказался очень удобным инструментом именно для разработки технической документации с её специфическим содержанием. Например, мы можем повторно использовать любой блок текста или целый раздел из одного документа в другом документе.
И это будет не привычный «copy-paste», а именно использование одного блока в разных документах. Если в этом блоке что-то изменится, нам достаточно будет поменять текст один раз — изменение автоматически попадёт во все документы. Ещё мы можем применять фильтрацию — написать один универсальный раздел, вставить в несколько документов и потом фильтровать его содержимое в зависимости от типа документа, заказчика, системы и других параметров. А ещё мы не задумываемся о перекрёстных ссылках между разделами — достаточно в нужном месте указать ключ раздела, на который мы хотим сослаться. Toolkit при сборке документа сам пронумерует разделы и сделает красивые гиперссылки.
Часто бывает так, что над одним документом работает несколько писателей. Чтобы в этом случае не было конфликта правок, у нас есть специальный чат, где можно оповестить своих коллег о начале работы с определённой частью документа или об обновлении общих коллекций, например — глоссария. Может, это и не самое технологичное решение, но оно работает. Никому из писателей не хочется потом «мёржить» merge куски сложных технических текстов. После обновления локальной копии SVN начинается работа.
Мы работаем по задачам в Jira. У нас есть специальный тип задач с префиксом DOC. Обычно они связаны с задачами на разработку или с запросами заказчиков. Задачи на документирование создают менеджеры, которые ведут проект, тестировщики, сотрудники службы поддержки. Заказчик тоже может инициировать изменение документации, задав вопрос, высказав пожелание или жалобу.
Team Lead нашей команды планирует деятельность каждого писателя, распределяет задачи, следит за их выполнением и отгрузкой документов. Для всех участников процесса разработки главное — не забыть создать задачу, ведь писатели должны откуда-то узнать о том, что что-то нужно задокументировать. К сожалению, у нас всё ещё бывают такие ситуации, когда подходит срок отгрузки новой системы, а заявка на документирование этой системы не создана. В этом случае чуда не произойдёт — документация не появится моментально. Внутренняя «кухня» — источники вдохновения Начиная работать над очередной задачей, писатель изучает многочисленные источники информации и преобразует полученные оттуда данные в пользовательскую документацию.
Источников у нас много. Самый главный — это технический проект ТП , которые пишут бизнес-аналитики ещё до начала разработки.
Ежедневно никто не станет напоминать, что тебе нужно описать. Процессом планирования занимается сам технический писатель: пересматривает документы отделов разработки что сделали, как это работает , открывает тестовые разработанные программы смотрит и вручную проверяет их работу.
И из всей полученной информации выбирает только то, что влияет на документацию. Теперь я создаю документ, в котором буду разрабатывать описание программы. Перед началом описания необходимо изучить функционал. То, как вы поймете его изначально, повлияет на качество текста в целом.
Чтобы посмотреть, как работает программа, запрашиваю ее в отделе разработки. Для начала в документе создаем примерную структуру — в какой книге будет располагаться новый текст, какие разделы появятся, что они будут в себя включать. Книги обычно подразделяются на руководства для пользователя, администратора и разработчика. В зависимости от этого, описание выполняется на языке, понятном представителю одной из ролей.
Например, для пользователя нужно писать «простым» языком, давать подробный порядок действий, для разработчика, напротив, нужны четкие формулировки с терминами, описание рабочих примеров кода. Вам сложно понять, что нужно писать, с чего начинать, как писать? Не переживайте. Для каждого типа описываемого объекта, например, справочник, сценарий или установка, имеется отдельный формат описания.
Формат задает структуру описаний, предоставляет готовые типовые фразы, правила оформления текста. Проще говоря, формат — это шаблон для новых текстов. Мы пишем не поэмы, не повести, требующие творческой окраски, мы пишем техническую документацию, которая должна быть простой, структурированной и понятной любому.
Стройная система подпорок и противовесов Хогвартс напоминает любой IT-проект, который разрабатывается долгое время. Древние баги, нигде не прописанные фичи, несовместимости, куча сдерживающих этот ужас костылей и несколько программистов, которые даже не хотят лезть в неведомые глубины и гордо называют их «школьными традициями». Мы уже привыкли и считаем нормальным, что у наших программ есть много недокументированных возможностей.
Если система живёт и развивается уже несколько лет, то в ней с каждым годом появляется всё больше исключений из правил. В неё добавляются новые функциональные возможности, старые отмирают или видоизменяются. Настройка системы становится всё сложнее, в интерфейсе появляется всё больше параметров, которые взаимодействуют друг с другом неочевидным и зачастую непредсказуемым образом. Постоянная гонка за быстрой реализацией новых бизнес-возможностей приводит к тому, что сокращается время на рефакторинг старого кода и устаревших интерфейсов. Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели.
Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации.
Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений. Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна.
Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок.
День из жизни технического писателя.
| Выставка к 100-летию писателя Виктора Астафьева. Новости | Регламент работы технического писателя группы документирования (далее – Регламент) описывает схему процесса документирования и определяет порядок работы технического писателя при создании документации. |
| Новости Москвы / Сайт Москвы | Увы, подавляющему большинству технических писателей приходится «вариться в собственном соку» и решать все свои вопросы самостоятельно. |
Похожие вакансии
- 5 июля 2023 года - 120 лет со дня рождения писателя Владимира Григорьевича Сутеева
- День технического перевода
- Вы можете заказать манипуляторы следующих моделей
- НОВОСТИ ДНЯ
Всемирный день писателя – 3 марта!
| TECHWRITER DAYS | Коллеги, наступил февраль, а с ним и День технического писателя — 2 февраля. |
| Один день из жизни технического писателя. Среда. | Презентация писателей – педагогов, внесших большой вклад в образование, подготовила библиотекарь ТТВТС Шевердяева И. В. |
| Краткий обзорный ролик TechWriter Days - Первой Международной конференции технических писателей | Умение создавать, редактировать, иллюстрировать и адаптировать технический материал, способность разбираться в незнакомых областях. |
| Один день технического писателя | Большую часть дня, исключая беседы и различные семинары, технический писатель посвящает себя работе за компьютером. |
День из жизни технического писателя в Алматы с зарплатой около 440 000 ₽
Самый главный источник — это технический проект ТП , которые пишут бизнес-аналитики ещё до начала разработки. Технический проект — это закон для разработчиков, тестировщиков и технических писателей. В идеале всё должно быть реализовано именно так, как написано в ТП. На деле же оказывается, что итоговая реализация отличается от ТП: что-то не учли, что-то поняли неправильно, что-то оптимизировали. Для того, чтобы узнать, как на самом деле всё было реализовано, используется техническое описание ТО , которое пишут разработчики. Там есть больше технических подробностей, описаны изменения конкретных типов данных и таблиц в БД, приведены алгоритмы работы процедур серверного кода, приведены скриншоты добавленных или изменённых окон в клиентских приложениях. Есть ещё один важный источник — описание настроек интеграционного тестирования.
Там подробно описаны все настройки, которые нужно сделать в системах, чтобы пройти все тестовые сценарии тест-кейсы. Этот источник незаменим для написания руководств по настройке. Технический проект, техническое описание и описание настроек — это основные источники, из которых писатель получает информацию. Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах. Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении.
Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано. Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация. Процесс работы технического писателя. Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего.
Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать. Вот как строится процесс работы: Определение главных задач документации и ее аудиторию. Составление плана технической документации и согласование его с заказчиком. Здесь скорее всего, будут изменения, поэтому важнее понять какие вопросы хочет решить заказчик. Изучение как работает программа или устройство. На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними.
Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту. Наполнение документа текстами и отправка его на проверку экспертам. Внесение правок от разработчиков и экспертов. Презентация документации заказчику. Передача документации команде.
Этапы не должны затягиваться. Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану. Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено. Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель.
Однажды он стрелялся с близким другом Кюхельбекером, потому что задел его обидной шуткой. В тот раз все обошлось, поскольку секунданты зарядили пистолеты клюквой вместо пуль. У Льва Толстого был очень неразборчивый подчерк.
Чтобы издатели смогли напечатать его произведения, жена и дочь вынуждены были переписывать рукописи.
Первое, что нужно сделать в этой жизни ранним утром - это покормить кошку. Иначе просто никак. Кошку зовут Фифа, смотреть в кадр она стесняется. Выглядываю в окно, там почему-то пасмурно, это странно, потому что вчера было безоблачно и ничего не предвещало беды. Пью чай с мятой и съедаю микроскопический бутербродик: 5. Одновременно смотрю погоду, сегодня у меня много "уличных" планов намечается. Погода теплая, но мокрая: 6.
Пора выходить на пробежку. Время: 7. Это стадион, на котором чудесное резиновое наверное покрытие, бегать одно удовольствие. Возможно сейчас пойдет дождь, но я сильная! Я не пугаюсь 8. Срочно бегу в душ! Время: 10. Теперь можно полноценно позавтракать!
Овсяная каша, огурец, помидор, хлеб и чай - радость для моего организма 11. Кошка тоже считаешь, что давно пора опять есть и составляет мне приятную компанию: 12.
Будут ли пользователи читать сопроводительную документацию на сайте? Как организовать пополнение FAQ? Почему техрайтер должен участвовать в создании онбординга? Где техписателю найти информацию о разработке для iOS и Android?
Рекомендуем посмотреть ссылки в заметке Что почитать о разработке документации для мобильных приложений , чтобы с большей пользой провести обсуждение новой темы.
Презентация "Профессия Технический писатель" для студентов НИУ ВШЭ (27.10.2020)
найм технических директоров, что бизнес ждёт от человека на позиции директора и какими глазами смотрит на соискателя. Станислав, вы описали самый отличный день технического писателя. В связи с отсутствием профессионального праздника у технических писателей предлагаю учредить его самостоятельно и ежегодно праздновать 17 сентября. День технического перевода. Степан ЖуринГазета «Лицейский вестник» и «Лицейское телевидение»15 октября 2019. День технического перевода. Степан ЖуринГазета «Лицейский вестник» и «Лицейское телевидение»15 октября 2019. День рождения инженера и писателя-фантаста 01.03.1981 Писатель-фантаст Александр Казанцев.
Физик и лирик. Технический писатель: Новые тенденции и требования в документации '23
З марта отмечается Всемирный день писателя03.03.2022 18:33 — ННТВ (видео). девушка при исполнении, а в свободное время - поэт. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского. 5-6 апреля в Москве состоится 1-я Международная конференция технических писателей TechWriter Days. Я технический писатель, хотя в последнее время скорее knowledge manager.
Всемирный день писателя – 3 марта!
Приходит нежданчик, сюрприз в коробке, ее открываешь, а там такое, — улыбается технический писатель. Я этого не писал! От китайцев постоянно сюрпризов только жди — приходит всё не так: провода с другими цветами и так далее. И приходится потом переписывать и перепечатывать, а дизайнерам — коробки перерисовывать.
Так что за косяки китайцев приходится отвечать не только мне, но и всем остальным. Вот какие ляпы возникают после китайской адаптации техники: 1 из 5 Источник: предоставлено героем публикации Технический писатель говорит, что изначально приходят инструкции на «китайском» английском, но за долгие годы работы он уже научился понимать, о чем идет речь. Иногда приходится сталкиваться и с «испорченным телефоном» — информация на иностранном языке проходит через цепочку сотрудников, прежде чем попасть к техпису.
Но мне нормально. Конечно, это очевидно, что они пишут не совсем по-человечески и нужно задавать дополнительные вопросы. И с этим бывает часто туго.
Потому что китайские менеджеры, которые принимают вопросы, часто не в курсе технических особенностей. И они потом перезадают вопросы своим инженерам, которые тоже могут быть не очень в курсе, потому что продукт делали инженеры с другой фабрики. Там очень длинная цепочка может быть.
Про скучные инструкции Молодой человек говорит, что в обществе есть стереотип о скучных инструкциях, и пытается его опровергнуть. По его словам, руководство пользователя пишется специальным языком, и вовсе не канцелярским. Но сухое описание можно вытянуть за счет рисунков, поэтому я стараюсь делать много иллюстраций и рисую все схемы сам, чтобы инструкции читались более интересно.
Я считаю, что благодаря рисункам можно многое понять: даже если буковки непонятны — смотрите картиночки, — признается технический писатель. Он сделал вывод, что инструкции чаще читают люди старшего поколения и лучше их понимают. А более старшие привыкли читать, и они лучше воспринимают инструкции.
С инженерского на русский Порой техписам приходится адаптировать инструкции не только с иностранного на русский, но и с нелитературно-инженерского.
Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах. Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении. Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано. Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация.
Процесс работы технического писателя. Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего. Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать. Вот как строится процесс работы: Определение главных задач документации и ее аудиторию. Составление плана технической документации и согласование его с заказчиком. Здесь скорее всего, будут изменения, поэтому важнее понять какие вопросы хочет решить заказчик.
Изучение как работает программа или устройство. На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними. Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту. Наполнение документа текстами и отправка его на проверку экспертам. Внесение правок от разработчиков и экспертов. Презентация документации заказчику.
Передача документации команде. Этапы не должны затягиваться. Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану. Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено. Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель.
Профессии технического писателя в российских вузах не учат. Есть курсы, где можно научиться писать технические тексты, но их немного. Поэтому осваивать такую профессию часто приходится по статьям в интернете, ориентируясь на примеры других. Это хорошая профессия для людей, желающих работать на стыке технического и гуманитарного направлений. В отличие от копирайтинга, здесь меньше творчества и больше регламентов. Soft skills и Hard skills технического писателя в концепции Модели компетенций команды цифровой трансформации в системе государственного управления подробно описаны в Профиле роли. Технический писатель должен сочетать в себе свойства технаря и гуманитария.
Интерес к технике и программированию, усидчивость и внимательность должны в нём сочетаться с желанием осваивать новое и делиться своими знаниями. Очень важно знать предметную область, в которой ведется работа. Например, если вакансия открыта в ИТ-компании, потребуется знать языки программирования и разбираться в процессах разработки софта.
Отображается последний отзыв. Попросим работодателя открыть отзывы","employerReviews. Возможно, сама компания рассказала о них в вакансии — посмотрите описание. Теперь соискатели видят 1 отзыв. Вы получили статус «Открытый работодатель»","employerReviews. Кандидаты увидят ответы на hh.
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. 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.
Наука и техника
The conference provides an opportunity for technical writers to share experiences, learn new techniques and tools, and enhance their professional development in the field of technical writing. 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?
Муж говорит, что будем мыть посуду в джакузи. Лениво восстаю, ползу приводить себя в порядок — душ, зубы, все такое. Есть не хочется — позавтракаю, когда все сделаю. Сажусь за комп, приходит идея по работе, вношу правки в статью. Звонит риелтор. Они с хозяйкой на месте — не могу ли я прийти пораньше?
Могу, хоть голова еще и мокрая. Идти семь минут. Обмениваемся документами. Пока риелтор заполняет бумаги, обговариваем с хозяйкой детали: что, когда, как будем связываться, что ей нужно оформить для нашего РВП. Читаем договор, я вношу несколько правок: указываю, что предупредить о посещении хозяйка должна за сутки, а о том, что квартиру нужно освободить — за месяц. Он вернется, если с квартирой все будет в порядке при нашем выезде. Все это мне потом компенсировал работодатель, поэтому в тратах не учитываю. Все, документы подписаны, счетчики сфотографированы, ключи переданы.
Иду в однушку завтракать и собирать вещи. Подъедаю остатки. Протеиновая овсяная каша с черникой — взяла на пробу, оказалось сладковато, но в целом норм, — шоколадный сырок, немного паштета из говяжей печени. Пакую в рюкзак остальную еду: хлеб, сахар, пачку замороженных овощей и пачку пельменей. Мою посуду, ополаскиваю раковину и ванну, заправляю постель: люблю, когда после меня остается порядок. Последний день в квартире, которую снимала посуточно Шмотки пихаю в чемодан. Он отказывается закрываться. Я играла в «Тетрис», чувак, когда тебя еще даже не планировали выпускать с конвейера!
С трудом застегнув чемодан и рюкзак, гордо оглядываю дело рук своих и краем глаза замечаю на кухонном столе пол-литровую пивную кружку, которую я привезла с собой, чтобы пить из нее чай. Второе «ха» звучит менее уверенно, но кружка таки помещается куда надо. Кстати, муж и дочь тоже привезут всего по одному чемодану на человека. Перевозим одежду и технику, остальное купим здесь. Вызываю такси: неохота прыгать с чемоданом. Отписываюсь хозяйке однушки, что съехала. Записываю видео свежеснятой квартиры, отправляю друзьям и мужу — короткое они уже видели, теперь показываю полностью. Начинается веселье.
Квартира пустая: мебель и техника есть, а в остальном — зеро. Надо купить хотя бы первичный набор посуды и текстиля. В «2ГИС» — он здесь работает лучше «Яндекса» — нахожу рядом супермаркет и хозяйственный магазин. Там же обнаруживается зоомагаз — удачно я зашла. Захожу в придворный ноунейм-магазин. Обзавожусь принадлежностями для мытья посуды и туалетной бумагой. И еще кастрюлей, мусорными пакетами и кухонным полотенцем. Я вообще планировала сперва снять другую квартиру и заказала в пункт рядом с ней подушку, одеяло и комплект постельного белья.
Но квартира отвалилась, потому что хозяйка сперва была не против животных и указала это в объявлении, а потом внезапно стала против. Ну и ладно, кто нашу кисоньку не любит, тот нам не друг. Но белье все равно ждет там, надо идти, благо недалеко — 25 минут пешком. Источник: wildberries. Все забрала.
Узнали интересные факты из его жизни. Но самой интересной частью встречи стала постановка пьесы «Снегурочка». Ребята с большим удовольствием выбирали роли и играли на импровизированной сцене. Встреча пришла очень интересно и познавательно.
Настройка системы становится всё сложнее, в интерфейсе появляется всё больше параметров, которые взаимодействуют друг с другом неочевидным и зачастую непредсказуемым образом. Постоянная гонка за быстрой реализацией новых бизнес-возможностей приводит к тому, что сокращается время на рефакторинг старого кода и устаревших интерфейсов. Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели. Это всё равно, что управлять атомным реактором, не прочитав предварительно многотомное руководство по интерфейсу пульта управления. Как говорил Гомер Симпсон: «На такую-то кнопку так сразу и не нажмёшь». Внутренние документы по системе, порождённые в процессе разработки, представляют для пользователя неразрешимую головоломку. Без пользовательской документации он просто «утонет» в многочисленных описаниях итерационных изменений, выполненных в различных местах системы. Задача технического писателя — всё это объединить, систематизировать, структурировать и изложить понятным пользователю стандартизированным языком. Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений. Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок. Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением. Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз».
Газета.Ру в соцсетях
Технический писатель: Новые тенденции и требования в документации '23 from Vlad Orlikov. TechWriter Days прошла 5-6 апреля 2024 в енция организована с целью собрать и объединить специалистов, занимающихся технической документацией. найм технических директоров, что бизнес ждёт от человека на позиции директора и какими глазами смотрит на соискателя. В России Всемирный день писателя отмечается сравнительно недавно, с 1986 года, и считается неофициальным праздником.