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

Публикации

easyDITA: Решение для создания и управления контентом организации (часть 3)

29.01.2014

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


Расширение структурированного авторинга и многоканальной доставки контента за пределы технических коммуникаций

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

Социально ориентированная документация продукта собирает ценную информацию о том, какой контент хотят клиенты, и помогает выявлять и удалять материал, который является неясным. Точный и адаптивный контент повышает удовлетворенность клиентов.

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



easyDITA: Решение для создания и управления контентом организации (часть 2)

27.01.2014

24.01.14Мы продолжаем обзор easyDITA – средства, призванного упростить процессы хранения, передачи и повторной обработки контента для писателей и редакторов. easyDITA также предоставляет системы совместной работы над контентом, широкий выбор средств публикации и широкие возможности интеграции с другим ПО.


Техническая документация является сложным, постоянно меняющимся направлением. Одним из преимуществ DITA является то, что она разбивает информацию на модули, так что при необходимости данные можно изменить в одном модуле, а затем они автоматически обновятся в каждом документе, использующем этот модуль. Без специальных технологий сложно эффективно управлять этими «компонентами». Поэтому easyDITA сочетает в себе средства разработки с полной системой управления контентом (CCMS) для обеспечения полной функциональности, необходимой для писателей, чтобы хранить, находить и повторно использовать контент.

CCMS полностью интегрируется в хранилище единого источника, в том числе включая изображения и мультимедийные файлы. Система работает в родной базе данных XML, которую можно организовать как на серверах заказчика, так и в облаке. Размещение easyDITA в облаке открывает возможности для сотрудничества в рамках всей организации без дополнительных затрат, возникающих при привязке лицензии на программное обеспечение к конкретному компьютеру, а также на развёртывание программного обеспечения. Владельцы контента назначают задачи авторам, рецензентам и ответственным за выпуск контента в автоматизированной системе документооборота easyDITA, которая позволяет управлять рецензиями отдельно от модификации контента, а также ведёт журнал регистрации всех действий при совместной работе. Кроме того, контент можно более эффективно локализовывать с уверенностью, что все языки готовы к работе одновременно, а это может уменьшить время выхода на рынок.

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



easyDITA: Решение для создания и управления контентом организации (часть 1)

24.01.2014

24.01Сегодня мы рассмотрим комплексное решение по созданию и управлению контентом, пока не представленное широко на российском рынке, easyDITA. Инструменты, предоставляемые easyDITA, могут быть полезны как опытным техническим писателям, так и начинающим редакторам и локализаторам.


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

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



Эджайл и технические коммуникации: 4 обязательных пункта, чтобы стать членом эджайл-команды (часть 2)

22.01.2014

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


Участвуйте во всех областях разработки

Независимо от того, сколько раз вы это слышали или говорили, фраза «Я просто писатель» не освобождает вас от активной вовлеченности – невозможно стать одним из ключевых членов команды без полного погружения. Алан Прингл пишет об этом на сайте Scriptorium. Такой уровень участия гарантирует, что вы полностью вовлечены в проект с самого начала и знаете все требования, дизайн и что стоит за дизайном программного обеспечения. И это даёт вам дополнительное преимущество: «имидж», уважение, которое нужно, чтобы остаться в проекте.

Вы можете заработать этот имидж, выполняя несколько важных действий:

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



Эджайл и технические коммуникации: 4 обязательных пункта, чтобы стать членом эджайл-команды (часть 1)

20.01.2014

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


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

Говорите

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

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



Технический писатель Google. 3 месяца в компании (часть 3)

17.01.2014

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


Слова, код, разметка

Нужно ли уметь писать код, чтобы быть техническим писателем в Google? Это наиболее обсуждаемый вопрос. Я думаю, всё зависит от должности, занимаемой в Google. Для моей позиции, я бы сказала, было бы весьма невыгодно не уметь скомпоновать программный код.

Почти все, что мы создаем – это слова. Мы пишем в HTML или Markdown в зависимости от нашего выбора, либо существующего формата, если мы обновляем документ.

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



Технический писатель Google. 3 месяца в компании (часть 2)

15.01.2014

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


День из жизни

Я приезжаю рано, около 7.30 утра. Но я прихожу на работу далеко не первая. Народ подтягивается в любое время суток – когда им удобнее.

Босые ноги, кофе, Большая Красная

Я бросаю ноутбук на стол и бегу к кофеварке. По пути я прохожу конференц-зал и улыбаюсь паре босых ног. Почему-то в это время дня здесь всегда находится парень, который развалился в кресле и чатится с кем-то через Google Hangout. Я вижу только ноги и коленки, выше стекло затемнено.  Думаю, он разговаривает с семьей где-то на другом континенте, а раннее утро – лучшее время их поймать.

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



Технический писатель Google. 3 месяца в компании (часть 1)

13.01.2014

13.01Представляем статью Сары Мэддокс, которая несколько месяцев назад получила место технического писателя в корпорации Google и теперь делится впечатлениями с читателями своего блога.


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

Тяжело ответить на этот вопрос. Это бодряще, страшно, весело, разочаровывающе, вдохновляюще, утомительно. Всё, чего можно ожидать от новой работы, и ещё многое. Мне это нравится. Чаще всего 😉

Чтобы ответить на вопрос, я начала записывать какие-то случайные мысли, а потом описала «день из жизни». Надеюсь, это даст вам некоторое представление о том, что я здесь творю.

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



Как писать кратко и понятно

10.01.2014

01Представляем статью Инны Якименко, эксперта по документированию компании First Line Software (г. Санкт-Петербург), посвящённую упрощённому техническому языку.


Поделюсь своим опытом технического писателя, как уложить свою мысль в краткую и легко воспринимаемую форму.

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

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



С Новым годом и Рождеством!

30.12.2013

Уважаемые друзья!
Спасибо за минуты общения, которые вы подарили нам в 2013 году. В 2014-ом году мы порадуем вас новыми ивентами, челенджами, тренингами и даже релизами 🙂
Желаем в Новом году творческой активности, финансового благополучия и лошадиной силы!
Оставайтесь с нами — будет интересно!

HNY