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

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

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

21.05.2014

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


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

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

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



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

19.05.2014

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


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

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

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



Кто переходит на DITA, а кому не надо и пытаться?

14.05.2014

14.05.14Ещё раз поговорим о DITA. Формат набирает всё большую популярность и, думаем, некоторые из вас уже задумались о переходе на DITA. Давайте попробуем разобраться, стоит ли это делать именно в вашем случае.


«Обещания» системы DITA сделать контент более структурированным и простым для публикации обращены к огромному количеству компаний, которые работают с огромным количеством технического контента. На данный момент на DITA переходят очень многие предприятия, где работают от одного техписа до компаний более чем 500 штатными писателями. Так подойдёт ли DITA вашей организации, и как понять, что она вам не подходит?

Кто переходит на DITA?

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



Единый источник (часть 2)

07.05.2014

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


Например, ваша компания находится в процессе выпуска комплексного программного приложения. Для поддержки нового софта понадобятся несколько типов документов:

  • Маркетинговые материалы;
  • Онлайн-справка;
  • Учебные материалы;
  • Руководство.

При использовании традиционных методов контент-авторинга для каждого типа будет создан отдельный документ. Но поддержка четырёх различных документов требует больше времени и усилий на их написание и обновление. Если обновление необходимо, то изменения можно внести во все документы, содержащие данный контент. Единый источник поможет вам сократить количество работы автора над различными документами для разных выходных форматов.

Зачем озадачиваться единым источником?

Основные аргументы за технологию единого источника – стоимость и постоянство. Читать дальше…



Единый источник (часть 1)

05.05.2014

05.05.14Много внимания в публикациях мы уделяем системе DITA и связанным с ней инструментам. При этом часто употребляется термин «единый источник». Что же конкретно подразумевается под этим понятием? Небезызвестная нам Сьюзен Бодник может ответить.


Передача информации становится все более сложным делом, так как информация должна адаптироваться к новым технологиям поставки контента. Информация передаётся в различных форматах и для разных аудиторий. Если вы ищете решение проблемы поставки контента в нескольких конечных форматах и для различных аудиторий, возможно, вас заинтересует единый источник. Технология единого источника – процесс, при котором вы создаете контент в одном общем источнике, обычно в формате XML. В этом едином источнике вы можете использовать процессы, которые публикуют контент в нескольких форматах. Например, ваши документы можно опубликовать как интерактивную справку (chm), PDF или HTML. С помощью единого источника вам нужно всего лишь один раз создать контент, а потом использовать его в многочисленных типах выходных документов.

Как единый источник мне поможет?

Публикация при помощи единого источника – больше, чем просто публикация документов в нескольких версиях в любой среде. Единый источник позволяет: Читать дальше…



Эджайл и технические коммуникации: командный подход (часть 3)

07.03.2014

07.03В завершающей части статьи речь пойдёт о сворминге – что это, и чем хорош этот подход в эджайл-разработке, о работе над ошибками, а также о том, как допускать как можно меньше ошибок при командной работе и, таким образом, копить как можно меньше «технических задолженностей».


Сворминг

Чтобы командный подход стал успешным, инженерам по качеству и членам группы разработки информации нужны хорошая поддержка и обучение, которые помогут им адаптироваться к быстрому темпу эджайл-разработки. Тесное сотрудничество внутри команды может потребовать от ее членов освоения новых навыков, и действительно важно дать им время для этого. Одним из способов это осуществить является сворминг (от англ. Swarming — роение, обозначает совместную работу «всем скопом»).

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



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

05.03.2014

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


Качество — это ответственность всей команды

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

Мы обнаружили, что для достижения наших целей в каждом спринте нам необходимо как можно больше автоматизировать тестирование. Автоматизированное тестирование быстрее, надежнее и менее подвержено ошибкам. Инженеры по качеству взаимодействует с группой разработки, чтобы обеспечить выполнение модульных тестов (unit tests) и повысить внимание к моментам, в которых существуют пробелы. Инженер по качеству должен также направлять усилия  на разработку и автоматизацию приемочных тестов (acceptance tests), а также на выполнение исследовательских тестов (exploratory tests). Другими словами, ручное тестирование — это не самый гибкий (agile) способ получения высококачественного продукта. Для получения дополнительной информации о гибком тестировании и различных видах тестирования смотрите блог Лизы Криспин (Lisa Crispin) www.lisacrispin.com.

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



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

03.03.2014

3.03.14Продолжаем публикации из данной серии. Сегодня мы узнаем, какие ошибки можно допустить даже при введении принципов скрама в команде. Своим опытом поделилась Алисса Фокс, директор по производству информации и программному менеджменту в компании NetIQ, Хьюстон, США.


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

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



Стоимость разработки контента (часть 6)

19.02.2014

19.02.14Итак, вы убедились в выгоде перехода на другие инструменты? И даже (мы вами гордимся) убедили в этом руководство? Думаете, самое сложное позади? А теперь попробуйте объявить о переменах сотрудникам. Только сначала прочитайте нашу статью, мы постараемся помочь.


Управляйте переменами

Дуглас Адамс сказал: «Перемены к лучшему. Ты оказываешься впереди».

Управление переменами является одной из самых сложных частей этого процесса. Экономическое обоснование ясно, сэкономленные деньги  и  затраты ясны. Что непонятно – это как изменить процессы, чтобы поддержать новую парадигму контент-разработки.

Другими словами: Как заставить людей изменить способ, которым они делают то, что они делают? Существует целая индустрия по изучению управления переменами. Мы можем призвать на помощь здравый смысл. Первый шаг для меня – это всегда выявление ожиданий.

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



Стоимость разработки контента (часть 5)

17.02.2014

17.02.14Вы всё еще не уверены, стоит ли менять инструмент разработки контента? Сомневаетесь в экономической выгоде такого решения? А может быть, вы давно уже решились, но не знаете, как объяснить это начальству? Возможно, наша следующая статья поможет вам определиться и найти аргументы для убеждения даже самого жадного босса.


Инструменты не бесплатны

Переход на новые инструменты разработки контента, которые поддерживают топикоориентированный подход к авторингу, стоит денег. Даже бесплатные инструменты небесплатны. Деньги нужны для:

  • Покупки инструмента (но существует и открытое программное обеспечение);
  • Обучения людей;
  • Изменения рабочих процессов;
  • Перевода в новый инструмент и форматирование контента;
  • И так далее.

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