Всё для технического документирования
+7 (925) 328-76-00
Разработка технической документации
Курсы для технических писателей
Программное обеспечение

Новости о техническом писательстве

Представляем MadCap Flare 2017 r2: Интеграция с Salesforce, улучшения в топ-навигации и другое!

31.07.2017

Вышел новый релиз флагманского продукта компании MadCap Software — MadCap Flare 2017 r2. Давайте посмотрим на нововведения, которые появились в этой версии данного продукта для автоматизации процесса документирования на предприятии. Напоминаем, что компания «ПроТекст» является единственным прямым партнёром компании MadCap Software в России, а программное обеспечение от этого производителя по-прежнему доступно в нашем магазине.


С нетерпением делимся подробностями о последнем релизе, MadCap Flare 2017 r2. Эта новая версия вышла со множеством новых функций и улучшений, она была разработана, чтобы дать вам ещё лучший контроль над тем, как вы создаёте, управляете и распространяете ваш контент, будь то техническая документация, стандарты и техпроцессы, медицинская или распорядительная информация, а также любые другие варианты. Читать дальше…



Адвокат пользователя: теория хаоса и практика — писатели и пользователи в эджайле

01.03.2017

Эджайл – беда или благо для технического писателя? Попробуем разобраться вместе с Филом Девисом, опытным техническим писателем из компании Integral Development Corp., США.


Эджайл. Эта философия оказывает влияние на ИТ-разработку с 90-х годов, но до сих пор нагоняет страх в сердца писателей уймой терминов и фундаментальных процессов, которые вызывают в воображении разные ужасающие последствия. Эджайл может звучать для писателя как нечто хаотическое и враждебное.

  • Скрам: Мир просто сочится заряженным тестостероном действием, мускулистыми потными членами команды, запертыми вместе и выступающими друг против друга. Как здесь найти место писателю? Я мяч, который топчут и выпинывают на газон?
  • Лин: Нет спецификаций? Я должен опираться на ежедневные митиниги, обсуждения лицом к лицу, потоки электронных писем, доски с задачами и систему отслеживания проблем? И я должен использовать эти источники для написания документации для продукта, который я, скорее всего не вижу или не использую?
  • Спринт: Я погружаюсь в скрам, спеша создать соответствующую документацию каждые две-четыре недели? Без спецификации? Или продукта? В то же время участвовать в ежедневных митингах по каждому скраму?

Читать дальше…



4 подсказки для локализации программного обеспечения и успешного развития эджайла (Часть 2)

10.12.2014

10.12.14Ваше программное обеспечение ещё находится на стадии планирования, а потенциальная необходимость его локализации уже сегодня портит вам настроение? Предлагаем вам убить сразу двух зайцев – оптимизировать процесс разработки, существенно сократив расходы и время на локализацию. Название этого решения — эджайл.

Ищите подрядчика для локализации вашего контента на иностранные языки или, наоборот, для перевода каких-либо текстов на русский? Специалисты компании «ПроТекст» с удовольствием помогут выполнить все стоящие перед вами задачи по переводу и локализации! Подробнее на этой странице.
Начало этой статьи читайте тут: 4 подсказки для локализации программного обеспечения и успешного развития эджайла (Часть 1)

Нацеливаемся на успех: 4 подсказки

То, что, возможно, случалось раньше – пропустить локализацию или тянуть с ней до последней минуты, не произойдёт с эджайлом. Следуйте следующим четырём подсказкам, чтобы убедиться, что всё идёт гладко. Читать дальше…



4 подсказки для локализации программного обеспечения и успешного развития эджайла (Часть 1)

08.12.2014

08.12.14Мы уже писали о преимуществах такого подхода, как эджайл, с точки зрения разработки софта и командной работы. Сегодня мы хотели бы рассмотреть ценность эджайла в локализации программного обеспечения.

Ищите подрядчика для локализации вашего контента на иностранные языки или, наоборот, для перевода каких-либо текстов на русский? Специалисты компании «ПроТекст» с удовольствием помогут выполнить все стоящие перед вами задачи по переводу и локализации! Подробнее на этой странице.
Продолжение этой статьи читайте тут: 4 подсказки для локализации программного обеспечения и успешного развития эджайла (Часть 2)

Если вы подумываете об эджайле (или уже переходите к этой модели), у вас может возникнуть вопрос, нужно ли что-то менять с точки зрения локализации.

Модели эджайл, хотя и не совсем новы, всё ещё остаются горячей темой обсуждения среди разработчиков программного обеспечения. И не зря. Изменению способа разработки программного обеспечения сопутствуют изменения в процессе локализации программного обеспечения.

У нас есть четыре подсказки, чтобы помочь настроить вас на успех эджайла. Имейте в виду также, что эти советы хороши для всех проектов по локализации программного обеспечения. Но они еще более важны при создании частых (и иногда очень быстрых) циклов. Читать дальше…



Эджайл и технические коммуникации: задаче-ориентированный контент в функцие-ориентированном процессе

20.08.2014

Ojective(Lens glass) isolated ion white.Мы продолжаем уже знакомую вам серию статей от Алиссы Фокс. Она детально углубляется во все тонкости эджайл-процессов и создаёт публикации, чтобы предостеречь нас от возможных ошибок.


Как я уже говорила в статьях Эджайл и технические коммуникации: командный подход ранее в этом году, авторы должны включать задачи своей работы в те же пользовательские истории, которые включают задачи отделов разработки и контроля качества. Такой подход гарантирует, что каждая пользовательская история действительно будет завершена в конце спринта, и помогает членам эджайл-команды из всех функциональных областей работать вместе, чтобы создавать «потенциально готовый к релизу» продукт в каждом спринте.

Несмотря на очевидные преимущества командного подхода, если вы не будете осторожны, структура эджайл-процесса может диктовать, какой контент вы будете писать. Поскольку команды часто попадают в ловушку, определяя пользовательские истории как функции, ваш контент может попасть в ту же ловушку – вы в конечном итоге задокументируете продукт, а не начнёте решать проблемы ваших пользователей с продуктом. Эта статья предлагает некоторые размышления для создания ориентированного на задачи (т.н. «задаче-ориентированного») контента, помогая сфокусировать контент на том, что необходимо пользователям для работы. Читать дальше…



Главные вопросы технической коммуникации

28.05.2014

28.05.14Эллис Пратт, коммерческий директор сервиса Cherryleaf, решил поднять главные вопросы сегодняшней технической коммуникации. Ответы на эти вопросы (которые могут предложить люди из других специальностей) повлияют на будущее развитие всей отрасли.


Какова ценность технической коммуникации?

Традиционно технические коммуникаторы страдают от того, что не знают, сколько людей извлекают пользу из их «продукта». Сегодня веб-контент позволяет узнать, сколько людей его прочитали или скачали. Можно провести параллель между технической документацией и количеством звонков в поддержку.

И всё-таки очень немногие технические авторы и люди, ответственные за документацию, это делают. И если контент-стратеги измеряют, изучают и многократно улучшают контент, технические авторы слепо уверены, что производят отличный контент, который нужен пользователю.

Во времена урезанного бюджета техническим писателям жизненно необходимо продемонстрировать ценность того, что они создают. Читать дальше…



Эджайл и технические коммуникации: работа с удалёнными командами (часть 2)

21.05.2014

21.05.2014Удалённая работа – актуальная и часто обсуждаемая тема. В нашей сегодняшней публикации мы попробуем помочь руководителям глобальных команд решить некоторые проблемы, возникающие при организации удалённой работы.


Знакомимся с членами команды

Некоторые знания о культуре удалённой команды помогут вам предугадать, как они будут взаимодействовать с другими (как с руководителями, так и коллегами) и как их личная жизнь будет пересекаться с работой. Некоторые культуры более иерархичны, некоторые менее. Понимание взаимоотношений различных уровней – это ключ к возможности сотрудничать с ними на их условиях. Это также поможет вам увидеть картину их правил, что необходимо, если вы хотите понять, почему возникло сопротивление к новым процессам и процедурам. И это даст вам возможность работать с ними, чтобы выявить сильные стороны обеих команд.

Возможно, эффективным методом для поддержания гармонии с другими членами команды будут частые встречи один на один или небольшие групповые совещания. Регулярные встречи с членами вашей команды внутри группы – гарант того, что никто не будет чувствовать себя брошенным; они также помогут установить связи, которые помогут вам в трудную минуту. Читать дальше…



Эджайл и технические коммуникации: работа с удалёнными командами (часть 1)

19.05.2014

19.05.14Алисса Фокс продолжает серию статей, посвящённых эджайлу. Сегодня мы рассмотрим проблемы организации удалённой работы в команде и пути их решения.


Все чаще и чаще мы видим команды, разбросанные по всему миру. Все большее число предприятий функционируют таким образом по целому ряду причин. Всем, кто работает в эджайл-среде, полезно выяснить, как лучше решать проблемы, связанные с моделью глобальной команды.

Трудности работы с удалёнными командами

Часто в удалённой команде встречается ситуация «мы против них», особенно когда две команды собираются вместе в результате слияния. У вас вдруг оказываются большие команды по крайней мере в двух местах, и несложно забыть, что команда где-то в другом месте является частью вашей глобальной группы. Кроме того, если у команд в разных местах разные фоновые знания, различные рабочие процессы и разные культуры, трудность налаживания процесса совместной работы растет в геометрической прогрессии. Читать дальше…



Работа на несколько эджайл-команд (часть 2)

16.04.2014

Заканчиваем статью Алиссы Фокс, посвящённую одному из аспектов эджайл-процесса. Публикация заставляет задуматься, а не ввести ли эджайл-процессы в своей компании. Тем более что выбор среди возможных стратегий довольно велик.


Когда вы работаете на несколько команд, вы можете тратить 4-5 часов в неделю (или больше) на совещания для каждого назначенного проекта. Переговорите с руководителем или менеджером, чтобы распределить нагрузку таким образом, что вы можете делегировать обязательства посещений совещаний другим. Вот несколько предложений:

  • Участвуйте только в совещаниях, которые относятся к самому приоритетному проекту на данный момент.
  • Попросите человека, проводящего совещания, отправлять отчеты по электронной почте, чтобы помочь тем, кто не может присутствовать на каждом заседании для каждого проекта.
  • Попросите руководителя или менеджера посещать некоторые важные встречи, когда вы не можете.
  • Перестаньте посещать ненужные встречи. Даже если исторически сложилось, что вы присутствуете на определенного рода встречах, если вы не получаете от них достаточно, чтобы расширить свои знания о продукте или внести вклад в контент, над которым вы работаете, возможно, ваш лучше потратить это время на что-то другое.
  • Всё больше и больше распределенных команд работают в эджайл-среде. Многие команды используют онлайн-инструменты для совместной работы для проведения совещаний и создания постоянных отчётов об обсуждениях. Рассмотрите возможность использования онлайн-инструментов для совместной работы для одной или нескольких ваших команд, что позволит вам, если вы пропустите встречу, проверить запись позже.

Читать дальше…



Работа на несколько эджайл-команд (часть 1)

14.04.2014

ЭджайлМы продолжаем публикации на тему эджайл-разработки. Сегодня Алисса Фокс поделится опытом, как организовать одновременную работу над несколькими проектами без ущерба для качества.


Обзор

Казалось бы, клише «делать больше с меньшими затратами» в большинстве компаний сегодня является суровой реальностью. Людям надо делать больше, а времени и средств на это у них меньше. Для софтверных компаний один из способов это осуществить – частое и постоянное движение ресурсов между несколькими проектами. Когда моя команда начала использовать процессы эджайл-разработки, мы долго искали информацию о том, как использовать этот процесс при работе на несколько эджайл-команд. Мы обнаружили, что большинство писателей, занимающихся эджайл-разработкой, работали всего с одной командой разработчиков. Как у «плавающих» писателей, у нас теперь есть уникальные проблемы в эджайл-разработке.

Читать дальше…