Сталин и писатели.
Работа технического писателя в IT-компании: цели, зоны роста, кому подходит
Полчаса смеялся, когда некая hbnf назначила (в философтовском форуме) 1 апреля Днем технического писателя. Всемирный день писателя отмечается не только литераторами, но и редакторами, корректорами, критиками, культурологами, журналистами и другими людьми, чья работа связана со словом. Дневник писателя Ф. М. Достоевского.
Физик и лирик. Технический писатель: Новые тенденции и требования в документации '23
Ими занимаются специальные писатели — технические. Один из них — герой нашего выпуска. О курьезных случаях, разочарованиях и том, огорчает ли его сокращение «техпис», молодой человек честно рассказал MSK1. Кто читает инструкции? В отличие от журналистов и авторов художественной литературы, к продуктам труда технических писателей люди обращаются довольно редко. Вспомните, когда в последний раз вы читали то, что лежит в коробочке от утюга или планшета.
Как говорят, в основном это бывает, когда у пользователя что-то сломалось. И тогда он ищет инструкцию, чтобы посмотреть причины неисправности, — объясняет технический писатель. Технический писатель — тоже человек и тоже порой ошибается. Иногда это выясняется сразу, но бывает, что проходит время. Порой даже очень много времени после продажи товара.
Несмотря на то, что уже модель не выпускается, всё равно надо, даже если прошло уже пять лет. Потому что поддержка-то модели идет. Это от пользователя в основном исходит, — объясняет молодой человек. Про плагиат Москвич рассказывает, что среди коллег и в узких кругах его профессию сокращенно называют «техпис». Признается, что название забавное, однако его это не смущает.
А еще технические писатели не защищены от плагиата, например со стороны конкурентов. Хотя молодой человек на них не в обиде и не считает свои авторские права ущемленными. Иногда, когда просто смотрю в интернете, на похожие натыкаюсь. И даже мне кто-то присылал из коллег — говорят, посмотри.
По формату — это круглый стол в виде вебинара. То есть, участвовать смогут, как обычно, все желающие, независимо от города и даже страны. Участие в наших встречах бесплатно.
На первый раз у нас есть ограничение по количеству участников — 30 человек. Поскольку, по нашему опыту, мероприятие посещают не все зарегистрировавшиеся участники, мы примем больше заявок — в качестве эксперимента мы остановим регистрацию на 50 участниках. Возможно, что вы зарегистрируетесь, но не попадёте на вебинар. Просим правильно понять этот момент и дождаться записи, которую мы обязательно выложим на сайте, а общение можно будет продолжить в комментариях на сайте и в соцсетях. Присоединяйтесь к нам всей компанией, но по возможности с одного компьютера, чтобы оставить больше свободных мест! Первый сбор На первый Доквариум мы приглашаем вас в четверг 28 июля, в 16:00 по московскому времени. Ориентировочно мероприятие займёт 2 часа.
Тема: «Инструменты технического писателя».
По итогам 2018 г. Уверенное владение офисным пакетом Microsoft Office работа со стилями, многоуровневыми списками, перекрестными ссылками и т.
С 1984 года журнал поменял своё название на «Хроника наших дней» изменились заставка и музыка журнала. В ряде городов СССР, например, в Минске, были созданы специальные кинотеатры «Новости дня» для демонстрации выпусков одноименного киножурнала.
Один день технического писателя
К Всемирному дню писателя редакция портала «Российское образование» вспомнила интересные факты о писателе, который считается и русским, и американским. онлайн на сайте Опыт работы в аналогичной должности (или инженером – электроником) от одного года.
Военная операция на Украине
Как организовать пополнение FAQ? Почему техрайтер должен участвовать в создании онбординга? Где техписателю найти информацию о разработке для iOS и Android? Рекомендуем посмотреть ссылки в заметке Что почитать о разработке документации для мобильных приложений , чтобы с большей пользой провести обсуждение новой темы.
А ведь есть ещё многочисленные комментарии в коде, которые тоже содержат много нужной информации.
В общем, текстов хватает. Так зачем же тогда в самом конце разработки нужен ещё и технический писатель? Почему всех этих документов недостаточно для того, чтобы дать ответы на основные вопросы заказчика и пользователя: как работает система и как её настроить? Будем разбираться. Разработчики должны писать код, а не текст «Условие, что поле PART должно быть не пустым, обеспечивается целостностью процесса, заполняющего это поле, и не обеспечивается отдельным ограничением Oracle типа NOT NULL для обеспечения максимального быстродействия при изменении данных таблицы».
Из внутренней документации проекта Бывает так, что программисты прекрасно разбираются в программе, досконально понимают все тонкости работы системы, но не могут красиво изложить всё это в текстовом виде. Лично я убеждён, что в этом нет ничего плохого. Согласитесь, что даже текст, написанный с орфографическими и стилистическими ошибками, может быть понятным и успешно выполнять свою функцию — доносить до читателя мысль автора. А ошибки — это дело поправимое, коррекцию и правку текста при необходимости может выполнить редактор или тот же технический писатель. Главное — не допускать ошибок фактических.
Каждый должен заниматься своим делом. Например, математику или физику часто проще написать формулу, чем объяснить словами какой-то закон. Программисту проще выражать свои мысли в виде кода и алгоритмических конструкций. Когда же дело доходит до формулирования чётких и понятных текстов на русском или другом языке, в дело вступает технический писатель. Это тот самый специалист, который переводит информацию с языка разработчиков на язык пользователей.
Не было бы технических писателей, и программистам пришлось бы самим напрягаться, пытаясь объяснить такие понятные и очевидные для них вещи обычным пользователям системы. Стройная система подпорок и противовесов Хогвартс напоминает любой IT-проект, который разрабатывается долгое время. Древние баги, нигде не прописанные фичи, несовместимости, куча сдерживающих этот ужас костылей и несколько программистов, которые даже не хотят лезть в неведомые глубины и гордо называют их «школьными традициями». Мы уже привыкли и считаем нормальным, что у наших программ есть много недокументированных возможностей. Если система живёт и развивается уже несколько лет, то в ней с каждым годом появляется всё больше исключений из правил.
В неё добавляются новые функциональные возможности, старые отмирают или видоизменяются. Настройка системы становится всё сложнее, в интерфейсе появляется всё больше параметров, которые взаимодействуют друг с другом неочевидным и зачастую непредсказуемым образом. Постоянная гонка за быстрой реализацией новых бизнес-возможностей приводит к тому, что сокращается время на рефакторинг старого кода и устаревших интерфейсов. Так и остаются в системе старые и недействующие параметры и настройки. Представьте, каково пользователям работать в такой «пожилой» системе без сопроводительной документации, которую пишут технические писатели.
Перерыв у вас будет возможность получить рекомендации по профессиональному развитию, поделиться своими проблемами, обсудить ситуацию на трудовом рынке и поспорить о роли писателей в меняющемся мире IT Круглый стол "Документация и справка мобильных приложений" с 20 ч. Мы обсудим вопросы: Какие новые термины из области мобильной разработки должен знать техрайтер? Необходимо ли техническое задание на мобильное приложение? Каким может быть туториал в мобильном приложении? Что писать в справке к приложению?
Она представила сборник «Сказки у костра», переизданный к столетию А. Митяева: Я приехала, чтобы передать вам привет из родных мест Анатолия Васильевича, из Рязанской области: он родился в посёлке Ястребки Сапожковского района. Анатолий Васильевич очень любил свою родину, приезжал несколько раз к нам в Рязань, видел свою школу, в которой учился. А мы, рязанцы, любим и помним Митяева, и как можем, сохраняем память о нем. В прошлом году, накануне столетия, благодаря Ие Николаевне Пестовой мы переиздали его «Сказки у костра». Эту книгу мы передаем в дар Российской государственной детской библиотеке. Подводя итог, Ольга Монина выразила благодарность всем, кто оказывал помощь и содействие в организации выставки: Мы благодарим Ию Николаевну Пестову за помощь в подготовке материалов к этой выставке, а также Георгия Махашвили и Василия Копейко — наследников художников — за возможность выставить работы их отцов в РГДБ.
5 июля 2023 года - 120 лет со дня рождения писателя Владимира Григорьевича Сутеева
Технических писателей. Конференция предоставляет техническим писателям возможность обмениваться опытом, учиться новым методам и инструментам, а также повышать свой профессиональный уровень в области создания технической документации. Официально считается, что профессия технического писателя возникла после Второй мировой войны, а свое развитие получило с изобретением компьютера. США после подписания законопроекта о военной помощи смогут начать снабжение украинской армии боеприпасами и вооружением с американских складов в Германии всего за несколько дней. В Кургане ожидается спад уровня воды в Тоболе до 30 см в течение 1-2 дней. Последние новости и события, происходящие в России и мире, а также комментарии и мнения экспертов.
Открылась выставка «С красной строки» к 100-летию со дня рождения писателя Анатолия Митяева
В какую сторону перевес — зависит от деятельности компании и конечного пользователя: можно писать инструкции к газовым котлам, а можно описывать миграцию данных. Даже если отбросить газовые котлы и остаться только в айти, документация по-прежнему будет разной. Её разделяют на внутреннюю и внешнюю, пользовательскую и разработческую, по гостам и нет. От целей документации зависит её язык, глубина раскрытия и много других подробностей. Описание миграции данных Какие знания и навыки нужны Российские университеты не выпускают готовых технических писателей. Поэтому сложно сказать однозначно, какое образование подходит, чтобы стать техписом. Компании примерно поровну хотят техписов-гуманитариев и техписов-технарей — опять же в зависимости от специфики проекта и назначения технической документации. Я по образованию журналист. И считаю, что диплом сыграл в мою пользу, потому что: — умею работать с текстами;— знаю, как брать интервью и превращать его в интересный рассказ; — умею добывать и обрабатывать информацию. Вот чем будет полезно техническое образование: — технический склад ума и системное мышление — отличные спутники в IT-сфере; — навыки программирования помогут понимать разработчиков; — опыт написания материалов технической направленности пригодится, чтобы формулировать сложные вещи простыми словами.
Образование лингвиста и знание фундаментальных основ языка помогут сделать тексты логичными и понятными для пользователя. И любое высшее образование научит добывать, отбирать и структурировать информацию, критически мыслить и быстро ориентироваться. Есть и базовый набор умений, которые не зависят от образования, но сильно упростят техпису жизнь: Грамотность. Теоретически неграмотный технический писатель может существовать, но ему будет нелегко. Конечно, при вычитке все ошибки найдутся и исправятся, но важно самостоятельно уметь превращать свои мысли в грамотные предложения. Техпис постоянно общается с разными людьми. С кем-то это легко и просто, а из кого-то информацию нужно добывать. Сложно представить на месте технического писателя интроверта, которого приводит в ужас мысль, что надо разговаривать. Например, заказчик говорит, что ему нужна документация.
У него есть макеты в «Фигме» и примерный флоу процесса. Выглядит так, будто для полноценной документации этого недостаточно. Но есть ещё хранитель знаний, которому, например, некогда эти знания превращать в текст. Тогда техпис собирает все возможные вопросы и идёт к хранителю выведывать информацию. Хранителем может быть любой человек из команды: разработчик, продакт, аналитик, юрист, дизайнер, кто угодно. Марина Вашак, технический писатель Умение писать коротко и по делу. Технический текст должен быть сухим, без лишних расшаркиваний. Техпис не гонится за количеством слов — наоборот, снимает с текста все «украшения»: обособленные обороты, составные глаголы, отглагольные существительные и прочую мишуру. Адекватное восприятие критики.
Политика и власть, бизнес и недвижимость, дороги и автомобили, финансы и работа, город и развлечения — вот только некоторые из тем, которые освещает ведущее петербургское сетевое общественно-политическое издание. Санкт-Петербург читает «Фонтанку»!
Плохая документация — это неоправданно дорого для компаний. Особенно, если она к продукту, которым пользуются многие.
За последние четыре года не раз видела случаи, когда технический писатель переписывал инструкцию и экономил часы и дни разработчиков. Например, техписатель понятно переписал онбординг, который прошли 500 человек. Это заняло у них 3 дня, а не 5. Оставшиеся 8000 часов можно потратить на разработку фич или ещё что-то полезное для компании, ведь теперь им не надо писать вопросы в чат поддержки.
Что должен знать и уметь технический писатель? Это тоже зависит от компании, продукта и существующих задач, но мы с вами обратимся к Хабр Карьере и посмотрим, что требует рынок. Есть почти во всех вакансиях в той или иной мере. В любом случае знание ГОСТ сильно облегчает работу и дарит навык структурирования.
Навыки сбора и анализа информации. Навыки сбора и анализа, а также описания требований — да, с требованиями техническим писателям приходится работать часто, и там есть серьёзные нюансы сбора, агрегации и «просеивания» собранной информации. Способность работать структурировать, перерабатывать с большими объёмами информации — и с каждым годом всё больше. Аккуратность, внимание к деталям.
Умение писать легко и понятно — пользователи разные, и информация должна быть доступная каждому. Отличное знание русского языка. Знание английского языка — как значительное преимущество, а часто и строго обязательное требование. Мария Смирнова О себе: деловой телеграм Есть расхожая фраза про то, что технические писатели — это «переводчики с разработческого на пользовательский».
При всей её заезженности и радикальности я скорее склонна с этим тезисом согласиться. Не в последнюю очередь из-за того, что я сама не только технический писатель, но и переводчик. Перевод для меня — это упражнение, похожее на сборку конструктора или паззла, решение интеллектуальной задачки. Абсолютно то же самое я нашла и в техническом писательстве.
Прелесть этой работы в том, что здесь можно применять творческий подход, оставаясь в чётко очерченных рамках и решая конкретную задачу. А именно на стыке этих двух методов и происходит настоящая магия. Как говорила матерь всех переводчиков Нора Галь, «переводить надо не слово, не букву, а дух и смысл». И я верю в то, что этот принцип должен лежать в основе любой работы с текстом, особенно в работе технического писателя.
С чем бы вы ни работали, думать о смысле — лучшее, что вы можете сделать для себя, для читателя и для заказчика.
Этот праздник был учрежден по решению 48-го конгресса Международного ПЕН-клуба, который проходил с 12 по 18 января 1986 года. Сам же ПЕН-клуб был основан в Лондоне в 1921 году. Название организации — это аббревиатура, образованная первыми буквами английских слов Poets — поэты, Essayists — очеркисты, Novelists — романисты.
ПЕН-клуб выступает в защиту свободы печати и против произвольного применения цензуры в мирное время. К Всемирному дню писателя редакция портала «Российское образование» вспомнила интересные факты про писателя, который считается и русским, и американским. В одном из интервью он сказал о себе: «Я американский писатель, рожденный в России, получивший образование в Англии, где я изучал французскую литературу перед тем, как на пятнадцать лет переселиться в Германию». Владимира Набокова называют одним из самых гениальных русскоязычных и англоязычных писателей.
Набоков - классик новейшей американской прозы, которого называют своим ближайшим предшественником К. Воннегут, Дж.