Последние новости и события, происходящие в России и мире, а также комментарии и мнения экспертов. Конференция для технических писателей – это событие, организованное с целью собрать и объединить специалистов, занимающихся технической документацией. #Кем_стать: техническим писателем Много знать и доходчиво излагать свои мысли, уметь писать и одновременно разбираться в технике и технологиях, чтобы сложные вещи объяснить простым и понятным языком – работа технического писателя Работа эта стоит дорого.
День технического писателя
Технический писатель: Новые тенденции и требования в документации '23 from Vlad Orlikov. К Всемирному дню писателя редакция портала «Российское образование» вспомнила интересные факты о писателе, который считается и русским, и американским. TechWriter Days прошла 5-6 апреля 2024 в енция организована с целью собрать и объединить специалистов, занимающихся технической документацией. Смотрите онлайн самые последние и важные новости канала ОТР на официальном сайте.
Оклад: 25000-30000 руб.
Полчаса смеялся, когда некая hbnf назначила (в философтовском форуме) 1 апреля Днем технического писателя. Известный нижегородский писатель Валерий Шамшурин так сказал о нем. Большую часть дня, исключая беседы и различные семинары, технический писатель посвящает себя работе за компьютером. День рождения инженера и писателя-фантаста 01.03.1981 Писатель-фантаст Александр Казанцев. Самые свежие новости России и мира, новости политики, шоу-бизнеса.
Лента новостей
Недаром у этого автора вышло более ста книг! В его произведениях много юмора и доброты. На его замечательные стихи написаны песни, по его произведениям сняты мультфильмы. Библиотекарь поселкового отделения познакомила воспитанников детского сада «Журавлик» с творчеством этого замечательного писателя.
Я подумала, что это хороший знак и меня ждет отличный день 19. Покупаю билет на электричку: 20. Смотрю расписание, а сзади меня уже крадется поезд: 21. Из окна можно лицезреть разные виды граффити - пошлые и не очень, красивые и страшные, милые и жуткие и много других.
Однажды появился новый рисунок, я ехала грустная и злая, но увидела его и сразу разулыбалась. Интересных граффити больше нет, можно почитать. Некоторое время назад решила перечитать всего Достоевского, очень развивает Жаль, что заграницей этого писателя любят намного больше, чем у нас в России. Я не буду показывать и описывать свой день в офисе, он не отличается чем-то интересным. Я сижу весь день уткнувшись в PHP-код, часто с угрюмым лицом, иногда среди тишины раздаются мои возгласы или возгласы программиста. Изредка смех технической поддержки и ооооооочень редко ворчание начальника. Конец рабочего дня официально в 7 вечера, но голова пухнет от компьютера и программного кода, меня ждет друг и я сбегаю из офиса.
Время: 25. Мы встретились и решили пойти в Парк Горького, я давно не была и мне все рассказывали, как здорово там сейчас сделали. А еще я сначала совсем забыла, что нужно фотографировать всё вокруг и вспомнила только на милых уточках: 26. Этой мой друг. Друга зовут Максим. Мы хотели покататься на лодках, но там была огромная очередь!
Чтобы стать востребованными и заполучить любовь читателей, идеи произведений должны быть актуальными и интересными Интересные факты об известных писателях: Настоящее имя Корнея Чуковского — Николай Васильевич Корнейчуков. При рождении он получил фамилию матери, но с первой же статьи стал подписываться псевдонимом Корней Чуковский. За всю жизнь Антона Чехова ни разу не видели в неопрятном виде. Он всегда следил за своей внешностью и даже за произведения садился, облачившись в парадный костюм.
Он оставил после себя творчество, которое необходимо, прежде всего, нашим детям. Нужно обязательно знакомить детей с произведениями Анатолия Митяева, они хрестоматийные. Леонид Носарев На открытии выставки выступила Татьяна Окружная, директор Рязанской областной детской библиотеки. Она представила сборник «Сказки у костра», переизданный к столетию А. Митяева: Я приехала, чтобы передать вам привет из родных мест Анатолия Васильевича, из Рязанской области: он родился в посёлке Ястребки Сапожковского района. Анатолий Васильевич очень любил свою родину, приезжал несколько раз к нам в Рязань, видел свою школу, в которой учился. А мы, рязанцы, любим и помним Митяева, и как можем, сохраняем память о нем.
#Кем стать: Техническим писателем
Олег Рябов - писатель, главный редактор журнала "Нижний Новгород", член союза писателей России: «Я пишу всегда утром, встаю рано, в 5-6, и вот 2-3 часа для меня наиболее плодотворные, очень долго входишь в канву, в тему, в тело того текста, который был написан в предыдущие дни и недели. Читаешь, что-то какие то запятые там исправляешь, меняешь абзацы какие-то и вот когда туда уже полностью входишь, вдруг начинает вырисовываться что же будет дальше». Первые тексты, вспоминает Олег Рябов, писал на чистом энтузиазме. Сейчас он уверен - писательство — занятие для личности зрелой, уже нажившей определенный опыт. В своих книгах и стихах Олег выделяет несколько основных тем, но главная — тема Родины.
Роман опубликовали в начале 1940-х годов, это стало началом 60-летней писательской карьеры. Он выпустил 13 романов в цикле «Георгий Седов», большинство из них были написаны в 50-е годы. Написал «Арктический мост», «Фаэты», «Тайна нуля», «Острее шпаги», «Клокочущая пустота» и многие другие книги. Его последний роман «Звезда Нострадамуса» вышел в 2000-м, а в 2001-м в соавторстве с сыном он написал фантастико-автобиографический роман «Фантаст». Несмотря на обширную библиографию, прозу Александра Казанцева экранизировали лишь однажды. Ведущий советский разработчик методов комбинированных съемок Павел Клушанцев снял фильм «Планета бурь» 1961 по одноименной повести, в которой герои отправляются на Венеру.
Новости 14 октября 2023 года Архангельская областная научная библиотека им. Добролюбова проводит седьмую областную акцию в поддержку книги и чтения «День с писателем». Цель акции — продвижение лучших образцов российской и региональной литературы, повышение престижа библиотек, развитие читательской культуры жителей Архангельской области. В 2023 году акция «День с писателем» посвящена 200-летию со дня рождения русского драматурга и писателя Александра Николаевича Островского.
Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно. Для того, чтобы достичь единства в этом вопросе, в компании должен существовать единый глоссарий терминов. Простой пример: один и тот же объект во внутренних документах может называться «системным параметром», «параметром системы», просто «параметром» или даже «записью в таблице параметров». Для разработчиков системы может быть понятно, что всё это — один и тот же объект. Для пользователя же это совсем не так очевидно. Может быть, после некоторого размышления, он догадается, что все эти названия описывают одно и то же. Но мы же любим наших пользователей, зачем постоянно заставлять их решать подобные головоломки? Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания. Так называются повторяющиеся фрагменты небольшого размера — словосочетания или короткие простые предложения. Например: «Функция … доступна в следующих режимах …» «Чтобы …, выполните в приложении … следующие действия: …» «Задайте системный параметр …» Для фигур описания иногда составляют отдельные словари или справочники. Казалось бы, мелочь. Но пользователь привыкает к определённым конструкциям и фразам. Если в одном месте документа написано «Выберите режим», а в другом «Перейдите в режим», у пользователя может возникнуть сомнения: здесь описано одно и то же действие или разные? Задача технического писателя — унифицировать весь тот зоопарк формулировок и терминов, которые употребляют в своих документах аналитики, разработчики и другие участники процесса разработки ПО. У технических писателей обычно есть свои словари терминов и фигур описания. Опытный писатель разбирается в системе и понимает, что именно означает тот или иной жаргонный термин во внутреннем документе. Вратарь разработки Технический писатель — лучший гуманитарий среди технарей и лучший технарь среди гуманитариев. Михаил Острогорский Выходит, что технические писатели в пользовательской документации исправляют все недостатки, ошибки и неточности, допущенные во внутренней документации и метаданных в процессе проектирования и разработки системы. Это тот самый рубеж, на котором «баг» то есть «изъян» волшебным образом превращается в «фичу», а «велосипеды» и «подпорки» — в стройную архитектурную схему из красивых разноцветных прямоугольников. Как известно, программист — это не тот, кто пишет программы, а тот, чьи программы работают. Точно так же технический писатель — это не тот, кто пишет технические тексты, а тот, чьи документы помогают пользователю решить проблему или найти ответ на вопрос. Раньше разработку пользовательской и эксплуатационной документации могли взвалить на программистов, хотя это совсем не их обязанность.
Открылась выставка «С красной строки» к 100-летию со дня рождения писателя Анатолия Митяева
Этот праздник был учрежден по решению 48-го конгресса Международного ПЕН-клуба, который проходил с 12 по 18 января 1986 года. Сам же ПЕН-клуб был основан в Лондоне в 1921 году. Название организации — это аббревиатура, образованная первыми буквами английских слов Poets — поэты, Essayists — очеркисты, Novelists — романисты. ПЕН-клуб выступает в защиту свободы печати и против произвольного применения цензуры в мирное время. К Всемирному дню писателя редакция портала «Российское образование» вспомнила интересные факты про писателя, который считается и русским, и американским.
В одном из интервью он сказал о себе: «Я американский писатель, рожденный в России, получивший образование в Англии, где я изучал французскую литературу перед тем, как на пятнадцать лет переселиться в Германию». Владимира Набокова называют одним из самых гениальных русскоязычных и англоязычных писателей. Набоков - классик новейшей американской прозы, которого называют своим ближайшим предшественником К. Воннегут, Дж.
Средняя заработная плата Средняя заработная плата по России технических писателей составляет от 40 до 90 тысяч рублей. Однако такая сумма условна, всё зависит от масштабности фирмы, стажа, профессиональных навыков сотрудника. О нас Образовательный портал TimeStudent для абитуриентов и студентов. Каталог учебных заведений, профессий, программ обучения, дни открытых дверей, новости и статьи об образовании.
Заметили ошибку?
Кстати, бывает, что аналитики, разработчики и тестировщики сами с трудом ориентируются во внутренней документации. Чтобы быстро найти ответ на свой вопрос они часто пользуются документацией, написанной техническими писателями. Ведь там всё аккуратно разложено по полочкам, структурировано и систематизировано. Нажми на кнопку — получишь непонятный результат «Клавиша имитации ручки выполняет переключение из исходного меню в меню ручек управления, которое позволяет выполнить функции ручек управления с помощью клавиши». Техническим писателям часто приходится описывать поля в окнах приложений.
Обычно это списки из пар «Название поля — описание». Если нам нечего добавить к названию поля, мы понимаем, что интерфейс спроектирован хорошо, а логика работы системы проста и понятна. Это характерный показатель того, что название поля полностью описывает его назначение и никаких исключений и особенностей в его работе нет. Но, к сожалению, так бывает редко. Чаще нам встречаются объекты с непонятным названием и назначением. Сколько раз мне приходилось описывать поля с названием «Дата начала» или просто «Дата»! Вот признаки плохого интерфейса, которые сразу видны техническому писателю: объекты с непонятным назначением, с невнятным названием или вовсе без названия; неочевидные и скрытые возможности интерфейса, о которых пользователь не может узнать без чтения документации; большое количество кнопок с непонятными пиктограммами, без описания и всплывающих подсказок.
Мне приходилось описывать интерфейсы, в которых на одной панели рядом было расположено несколько кнопок с одинаковыми пиктограммами и разным назначением. Но даже если интерфейс спроектирован хорошо и качественно, в сложных системах всё равно будет требоваться его описание. Хотя бы для того, чтобы внятно объяснить пользователю, почему ему недоступно для редактирования то или иное поле. Или чтобы составить списки доступности просмотра и редактирования полей в зависимости от роли пользователя. Изъян привёл к конфузу Решили, что «баг» — это «изъян», а «инцидент» — «конфуз». Думаю, излишне говорить, что для достижения нормального взаимодействия между всеми участниками процесса разработки, они должны использовать единую терминологию. Если же терминология размыта, один и тот же объект может называться по-разному, то договориться будет очень сложно.
Для того, чтобы достичь единства в этом вопросе, в компании должен существовать единый глоссарий терминов. Простой пример: один и тот же объект во внутренних документах может называться «системным параметром», «параметром системы», просто «параметром» или даже «записью в таблице параметров». Для разработчиков системы может быть понятно, что всё это — один и тот же объект. Для пользователя же это совсем не так очевидно. Может быть, после некоторого размышления, он догадается, что все эти названия описывают одно и то же. Но мы же любим наших пользователей, зачем постоянно заставлять их решать подобные головоломки? Есть ещё одна важная особенность технических текстов: кроме правильного употребления общих терминов важны также фигуры описания.
Технические писатели могут писать лаконичнее без потерь в качестве, что в результате даёт более короткие инструкции и сниженные расходы на печать: менее объёмные документы требуют меньше времени на проверку, тем самым снижаются расходы на неё; на коротких документах проще сосредоточиться, соответственно улучшается качество проверки. Основная работа технического писателя — писать, и профессиональные писатели создают документацию быстрее, чем разработчики продукта. Даже если найдётся тот редкий разработчик, который пишет быстро и эффективно — он запросто может обойтись вам в два раза дороже по оплате труда в час, чем технический писатель, и пока пишет, он не будет производить ничего, что вы сможете продать. Наём технического писателя не только снижает затраты на разработку документации, но и освобождает разработчиков продукта для работы, на которую они были наняты. Даже если «этот снаружи» сидит в соседней команде. Любое погружение посторонних в проект или продукт уже подразумевает документацию, а, следовательно, и позицию технического писателя. Но у меня в практике был проект, когда документации нет и это не создаёт никаких реальных проблем. Вот тогда и писатель не нужен.
Или к примеру, у меня в команде был такой разработчик, что он прекрасно пишет документацию и ему проще сделать это самому — вот такое у него хобби » Максим, директор департамента разработки ИТ-компании Какую карьеру может построить технический писатель? Технический писатель может выбрать для себя разные пути развития. Очень многое зависит от проекта, над которым работает технический писатель. Если брать сферу IT, ближе всего к техническому писателю профессия бизнес-аналитика. Там требуются схожие качества: внимание к деталям, аналитический склад ума, стремление разложить все по полочкам. Из технического писателя получаются прекрасные специалисты по тестированию. Технический писатель может стать менеджером проектов, попробовать себя в тестировании. Если человек писал много документации о программах на Java, заинтересовался и решил изучить этот язык программирования, он может стать разработчиком.
Некоторые технические писатели уходят в сферу маркетинга или продаж, особенное если это направление по продвижению IT-продуктов: умение структурировать информацию и наглядно представлять её помогает готовить презентации для потенциальных клиентов, а умение понимать нужды клиента или пользователя, предугадывать его вопросы, незаменимо в этой области. Многие технические писатели предпочитают работать на различных проектах: являясь фрилансерами, они вольны выбирать для себя наиболее интересные проекты, совершенствуя свои навыки в разных направлениях. Развиваясь, они становятся незаменимыми специалистами на биржах по поиску специалистов. Это интересно как самому техническому писателю, так и работодателю: специалист задействован на определенные задачи и трудовых отношений часто не возникает. Я всегда мечтала путешествовать, поэтому очень много время уделяла изучению иностранных языков. Журналистика не пошла, хотя очень нравилось писать технические тексты. Знакомые предложили попробовать себя в IT — необходимо было разобраться с высокотехнологичным продуктом в помощь основному техническому писателю. Вот с этого началось мое погружение в IT.
Несколько лет я работала в компании, пока наконец не поняла, что хотела бы совмещать мою любовь к путешествиям и любимую работу. Сейчас я фрилансер, заказы есть всегда, иногда даже привлекаю молодых специалистов к решению задач». Марина, технический писатель-фрилансер Заработная плата технических писателей. На июль 2021 года на известном ресурсе по поиску работы были найдены 335 вакансии по Москве и Московской области. С примером описания вакансии можно ознакомиться здесь. Средний размер заработной платы: от 100 000 до 150 000 рублей. Если технический писатель принял решение работать как фрилансер, то ежемесячный уровень дохода примерно 150 000 — 200 000 рублей при наличии опыта от 3х лет. Первые заработки начинающих технических писателей начинаются от 5 000 — 10 000 рублей за проект.
Заключение: В России профессия технический писатель является востребованной в основном на крупных проектах. Благодаря этим специалистам упрощается процесс коммуникаций и снижаются затраты на документацию и техническую поддержку. В ВУЗах России такой профессии не обучают и в нее можно попасть как имея техническое так и другое образование. Необходимо обладать определенным набором soft skills и активно совершенствовать профессиональные навыки. Спрос на технических писателей неуклонно растет и многократно превышает предложение: раньше технических писателей не было вообще, а теперь они нужны почти каждой IT-компании.
TECHWRITER DAYS
Это полезно, так как РП тяжело погружаться в эти юридические тонкости. И здесь задача технического писателя — прикрывать РП по формальной части. Вертикальный рост технического писателя Вертикальный рост технического писателя прост и понятен. В подразделении Nota. Docs четко выстроена градация между специалистами уровня Junior, Middle и Senior: Junior — новичок, обладающий базовыми компетенциями: грамотность, владение MS Office, системность и структурированность мышления, внимательность к деталям. Но ему нужна помощь от более опытных коллег по ряду вопросов. Middle — это человек с опытом, который работает самостоятельно. Если ему поставили задачу, он не прибегает к помощи других коллег-техписов. Это не означает, что он не имеет права задавать вопросы другим участникам проектной команды. Но значит то, что за ним не надо проверять. Он знает, как добыть информацию, к кому пойти по тому или иному вопросу и знает срок, к которому все должно быть сделано, а также в каком объеме и качестве.
Senior — это уже расширенные компетенции и нечто большее, чем все функциональные обязанности специалиста Middle. Это «большее» может быть с точки зрения, например, управленца — то есть человек, который ставит задачи нескольким мидлам. Или человек, который глубоко знает определенную предметную область или систему. Поэтому специалист может вырасти до ведущего технического писателя, в подчинении которого находится несколько специалистов, затем — в руководителя подразделения технической документации. Кому подходит карьера технического писателя Главное качество, которое отличает технического писателя — это ответственность. Потому что мы работаем с формальным треком, который с крупным заказчиком проходит через его внутренний электронный документооборот, сопроводительные бумаги и письма. Поэтому невозможно физически договориться о том, что мы сегодня не успели и сделаем завтра. Если срок сдачи документа — 30 сентября, то не позднее этого дня он должен быть любой ценой. Но при этом вариативность типа личности, которому подходит карьера технического писателя, велика. Есть люди, которые целый день проводят в переговорах, обсуждении договоренностей и планов.
А есть те, кто сидит и разбирается в функциональности продукта, выясняет, что за полгода сделали разработчики. Именно от специфики проекта зависит тот склад ума и характера человека, который под него подходит. Предположим, в компании открыто несколько вакансий технических писателей на разные проекты. Давайте смоделируем несколько ситуаций: проектов и подходящих под них типажей кандидатов. Типаж 1 — «библиотечный бука» Есть проект А, на котором приходится писать сложные документы. Например, пояснительную записку на 1000 страниц с техническими подробностями. Человек, который подходит под этот проект, может быть не очень коммуникабельным, но должен быть своеобразным «библиотечным букой»: зарыться в техническую информацию и сидеть с ней разбираться, выстраивая из этого стройный текст. Типаж 2 — «решала» Проект Б. На проекте много согласующих, но несложная документация. Не требуется глубоко лезть в технические вещи.
На этом проекте, чтобы согласовать небольшую стопку документов, нужно встретиться с заказчиками и с 5-6 людьми договориться, понять, что они хотят, найти к каждому подход.
Технический проект — это закон для разработчиков, тестировщиков и технических писателей. В идеале всё должно быть реализовано именно так, как написано в ТП. На деле же оказывается, что итоговая реализация отличается от ТП: что-то не учли, что-то поняли неправильно, что-то оптимизировали. Для того, чтобы узнать, как на самом деле всё было реализовано, используется техническое описание ТО , которое пишут разработчики. Там есть больше технических подробностей, описаны изменения конкретных типов данных и таблиц в БД, приведены алгоритмы работы процедур серверного кода, приведены скриншоты добавленных или изменённых окон в клиентских приложениях. Есть ещё один важный источник — описание настроек интеграционного тестирования. Там подробно описаны все настройки, которые нужно сделать в системах, чтобы пройти все тестовые сценарии тест-кейсы.
Этот источник незаменим для написания руководств по настройке. Технический проект, техническое описание и описание настроек — это основные источники, из которых писатель получает информацию. Но есть ещё множество дополнительных: исходный код серверных процедур и клиентских приложений, XML-описания параметров, страницы в базе знаний Wiki, наконец — вопросы разработчикам и тестировщикам в мессенджерах. Ну и, конечно, сами системы — их web-интерфейс, клиентские и серверные приложения. Задача писателя — объединить всю полученную информацию и написать простую, понятную и хорошо структурированную документацию о системе или решении. Тут нужно быть очень внимательным — ничего не перепутать, не забыть, описать именно то, что было реализовано. Писатель должен самостоятельно разобраться во всех особенностях реализации, понять все алгоритмы и принципы работы системы от начала и до конца. Только так получится хорошая и качественная документация.
Процесс работы технического писателя. Чаще всего у документации есть заказчик. Это может быть менеджер, разработчик, дизайнер — любой человек, осознавший, что есть какая-то проблема в понимании происходящего. Задача технического писателя — определить, реальна ли проблема и в каком формате её нужно решать. Вот как строится процесс работы: Определение главных задач документации и ее аудиторию. Составление плана технической документации и согласование его с заказчиком. Здесь скорее всего, будут изменения, поэтому важнее понять какие вопросы хочет решить заказчик. Изучение как работает программа или устройство.
На этом этапе важно найти экспертов, кому можно будет задавать уточняющие вопросы и договориться о формате работы с ними. Обязательно уточнить что непонятно у инженеров. Поиск и подготовка иллюстрации к тексту. Наполнение документа текстами и отправка его на проверку экспертам. Внесение правок от разработчиков и экспертов. Презентация документации заказчику. Передача документации команде. Этапы не должны затягиваться.
Если пошёл уже пятый круг обсуждения структуры документа, который ещё даже не начали наполнять — что-то пошло не по плану. Финальное согласование с окончательной заморозкой структуры и текста происходит только тогда, когда уже всё написано и проверено. Своих технических писателей я учу: при постановке задачи важно, чтобы заказчик не пытался переписать ваш текст согласно своему субъективному взгляду. Факты и термины — да, тут он эксперт, но вкусовщину надо учиться фильтровать, иначе процесс может затянуться». Елена, технический директор IT-компании Что должен знать и уметь технический писатель. Профессии технического писателя в российских вузах не учат.
Написал «Арктический мост», «Фаэты», «Тайна нуля», «Острее шпаги», «Клокочущая пустота» и многие другие книги. Его последний роман «Звезда Нострадамуса» вышел в 2000-м, а в 2001-м в соавторстве с сыном он написал фантастико-автобиографический роман «Фантаст». Несмотря на обширную библиографию, прозу Александра Казанцева экранизировали лишь однажды. Ведущий советский разработчик методов комбинированных съемок Павел Клушанцев снял фильм «Планета бурь» 1961 по одноименной повести, в которой герои отправляются на Венеру. В книге писатель впервые использует слово «инопланетянин», которое вошло в обиход и стало привычным для всех. Эту картину купили на Западе, причем показывали не только оригинальный вариант, но перемонтировали в два варианта с названиями «Путешествие на доисторическую планету» и «Путешествие на планету доисторических женщин».
В 2010 году вышел в свет сборник избранных стихов, написанных Владимиром Николаевичем в разные годы, который так и назван "Изборник". Новгород: изд-во «Вектор ТиС», 2004. Владимир Гофман. Новгород: изд-во «Книги», 2004. Гофман, В. Новгород, 1998. Новгород, 2000. Сборник 1. Гофман, Т. Панченко, Б. Новгород: «Эльдорадо», 224 с. Нижний Новгород: изд-во «Книги», 2009.
#Кем стать: Техническим писателем
Новые инсайты и практика технологического обновления в программе Дня технического специалиста Форума PulpFor 2023! Доклад Марии Макеевой на конференции AnalystDays #17 27-28 октября 2023. г. Москва Россия Актуальные и свежие новости в стране и мире, эксклюзивные материалы и мнения экспертов.