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

Публикации

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

03.03.2014

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


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

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



Ввод текста в форму PDF

28.02.2014

28.02.14Наверное, каждый из нас сталкивался с необходимостью заполнения какой-нибудь PDF-формы (налоговая декларация, анкета на подачу визы и т.д.), которая наотрез отказывается заполняться. Поэтому приходится распечатывать документ, заполнять его вручную, сканировать. Какая бездарная трата времени, правда? В статье вы узнаете, как справиться с этой проблемой.


Вопрос: Почему в некоторых PDF-документах возможен ввод текста, а в других нет? Есть ли какой-нибудь способ заполнять любые PDF-формы  без необходимости их распечатывать?

Ответ: Некоторые PDF-файлы создаются специально, чтобы воспринимать и сохранять введенный текст. Эти интерактивные PDF формы, как правило, называют «заполняемыми», и их можно создать с помощью нескольких программ, в том числе Adobe Acrobat или Microsoft Word. Статические или «незаполняемые» формы, которые не воспринимают ввод текста, часто оказываются сканами бумажных документов или файлов, предназначенных для печати.

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



Онлайн-конференция ТехДок 2014: Софт

26.02.2014

techdoc2014soft

 

 

 

 

Дорогие друзья!

26 марта состоится тематическая онлайн-конференция для технических писателей ТехДок 2014: Софт. Общая тема, которой будут посвящены все доклады – программное обеспечение для документирования. Среди докладчиков будут присутствовать как производители софта, которые расскажут о своём продукте, так и пользователи – они поделятся своим опытом использования различных инструментов. Докладчики не только расскажут о продуктах, но и продемонстрируют их работу в реальном времени.

Участие в конференции бесплатно, регистрация обязательна.

Начало конференции – в 10.00 по московскому времени.

Компании-участники и темы их докладов:

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



Конкурс «Конёк документатора»

konkurs_big

Дорогие друзья!

В преддверии конференции ТехДок 2014: Софт, которая пройдёт 26 марта, мы объявляем о проведении конкурса «Конёк документатора».

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

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



Технические коммуникаторы: новое название, новые проблемы

26.02.14Люди, решившие связать свою жизнь с техническим писательством (впрочем, как и представители многих других профессий), часто задумываются: «А что если область моей деятельности отмирает? Есть ли у моей профессии будущее?». Вот и мы заинтересовались этим вопросом на примере Индии. А может, у вас есть размышления и наработки, как обстоят дела в России? Тогда ждём ваших комментариев.


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

Со стороны должность технического писателя может выглядеть как пресловутое «злачное место», но занятые в данном секторе предполагают, что это далеко не так. Хотя зарплата довольно привлекательна, да и льготы неплохие, специалисты в технических коммуникациях рассказывают о том, как трудно сохранить рабочие места. Увольнения становятся большим подводным камнем.

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



Dr.Explain как инструмент технического писателя

24.02.2014

01Введение

В современном мире присутствует большое количество различных устройств, прикладного и специализированного программного обеспечения, использование которого без сопроводительной документации зачастую связано со значительными техническими и временными издержками. И поэтому создание качественной и понятной документации является принципиально важным фактором. Занимаются разработкой и ведением технической документации т. н. технические писатели — как правило, универсальные специалисты, способные не только разобраться в технических аспектах работы, но и грамотно их описать. В процессе работы над документацией остро возникает необходимость в удобном инструментарии, позволяющем выполнять типовые операции с минимальными затратами. Ведь техническому писателю нужно максимально быстро и просто изложить основные принципы работы устройства или программного обеспечения. Немаловажную роль в этом играют программы для создания справочных материалов в широко распространённых форматах — CHM, HTML, PDF. Одним из примеров подобных программ является продукт компании Indigo Byte Systems, LLC — Dr.Explain, о которой и пойдёт речь в данном обзоре.

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



Алфавит техписа

21.02.2014

21.02.14Считаете, что технические писатели – это такие специальные скучные люди, с которыми можно поговорить только о пользовательских интерфейcах и сложностях форматирования в PDF? Не угадали. Техпис – очень творческая профессия, а Иешуа Пол даже сочинил стихотворение о сложных рабочих буднях технического писателя. Мы намеренно не стали его переводить, так как поэзией надо наслаждаться в оригинале. Ну а если вам непонятны некоторые слова, значит настало время расширять словарный запас. Подсказка: эти термины встречались в наших предыдущих публикациях.


A is for Acrobat to publish in print

B is for backup – you shouldn’t need the hint

C is for content which is produced en-masse

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



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

19.02.2014

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


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

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

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

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

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



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

17.02.2014

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


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

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

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

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



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

14.02.2014

14.02.14Ранее мы рассматривали стоимость разработки контента. А во сколько обойдётся его локализация? Если вы считаете, что это вас не касается и переводить свой контент вы никогда не будете, прочитайте сперва данную статью.


Ранее я рассказывала о стоимости разработки контента в Word, FrameMaker и InDesign, а также топикоориентированных инструментах. Цифры показывают, что дешевле работать в топикоориентированных инструментах авторинга из-за возможности повторного использования контента. А что насчёт локализации?

Локализация

Локализация – процесс перевода контента и адаптация его к другой культуре. Он включает не только перевод с одного языка на другой, но и изменение системы мер и поиск примеров, подходящих для данной культуры.

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