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

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Выбрать дату в календареВыбрать дату в календаре

Страницы: 1 2 3 4 5 6 След.
Dr.Explain 5.6: Актуализированная русская справка. Автосохранение. Анкоры, Новая версия - новые возможности.
 
Коллеги.

[B]Рады представить вам новую версию программы для быстрой разработки пользовательской документации - Dr.Explain 5.6[/B]

Что нового:
[LIST]
[*][B]Новый русский файл справки, сразу включенный в установочный пакет. [/B]
Теперь пользователи, работающие в русскоязычном интерфейсе, будут сразу видеть актуальную русскоязычную справку.
[*][B]Автосохранение проектов[/B]
Ваша работа не пропадет даже в случае внезапного выключения питания.
[*][B]Якоря (anchors)[/B]
Вставлять именованные якоря в текст и ссылаться на них из других разделов стало очень просто.
[*][B]Обновленный интерфейс[/B]
Переработанные диалоги функций текстового редактора стали удобнее.
[*][B]Десятки исправлений и оптимизаций[/B]
Работать станет проще и приятнее.
[/LIST]Обновление бесплатно для всех владельцев лицензий версии 5.xx и доступно для установки на странице [URL=https://www.drexplain.com/download/?tw]https://www.drexplain.com/download/[/URL]


Всегда рады вашим отзывам и предложениям.
Несмотря на отпускной сезон, мы продолжаем работать над очередным обновлением. К осени мы готовим очень крутые штуки.
[Кейс] Dr.Explain в медиагруппе Актион-МЦФЭР, Используя Dr.Explain, медиагруппа Актион-МЦФЭР сократила число обращений в техническую поддержку
 
Продолжаем публикацию серии пользовательских кейсов-примеров использования Dr.Explain в различных компаниях и проектах.

[QUOTE][B][CASE] Используя Dr.Explain, медиагруппа Актион-МЦФЭР сократила число обращений в техническую поддержку[/B]
[I]Дмитрий Лашхиа, руководитель отдела поддержки и развития бизнес-процессов медиагруппы «Актион-МЦФЭР» рассказал о том как Dr.Explain помог компании повысить эффективность работы с партнерской сетью.[/I]

[URL=https://www.drexplain.ru/cases/ispolzuya-dr-explain-mediagruppa-aktion-mtsfer-sokratila-chislo-obrashcheniy-v-tekhpodderzhku/]https://www.drexplain.ru/cases/ispolzuya-dr-explain-mediagruppa-aktion-mtsfer-sokratila-chislo-obrashcheniy-v-tekhpodderzhku/[/URL][/QUOTE]


Больше: [[URL=https://www.drexplain.ru/cases/]Кейсы от русскоязычных пользователей[/URL]] [[URL=https://www.drexplain.com/cases/]Кейсы от международных пользователей[/URL]]
[Кейс] Dr.Explain в компании CRM Expert, CRM Expert стал использовать Dr.Explain и теперь “техподдержка сидит довольненькая”
 
Продолжаем публикацию серии пользовательских кейсов-примеров использования Dr.Explain в различных компаниях и проектах.

[QUOTE][B][CASE] CRM Expert стал использовать Dr.Explain и теперь “техподдержка сидит довольненькая”[/B]
[I]Наталья Обухова, бизнес-аналитик компании CRM Expert, рассказывает, какие проблемы IT-компания испытывает без полноценной пользовательской документации в продуктах, и почему Dr.Explain обошел конкурента при выборе решения для создания и управления такой документацией.[/I]

[URL=https://www.drexplain.ru/cases/crm-expert-stal-ispolzovat-dr-explain-i-teper-tekhpodderzhka-sidit-dovolnenkaya/]https://www.drexplain.ru/cases/crm-expert-stal-ispolzovat-dr-explain-i-teper-tekhpodderzhka-sidit-dovolnenkaya/[/URL][/QUOTE]


Больше: [[URL=https://www.drexplain.ru/cases/]Кейсы от русскоязычных пользователей[/URL]] [[URL=https://www.drexplain.com/cases/]Кейсы от международных пользователей[/URL]]
Изменено: ''Dr.Explain'' - 28.03.2018 12:09:53
[Кейс] Dr.Explain в веб-студии ТаймДизайн, Веб-студия Тайм Дизайн снабжает все разработанные веб-проекты пользовательскими инструкциями, созданными в Dr.Explain
 
Продолжаем публикацию серии пользовательских кейсов-примеров использования Dr.Explain в различных компаниях и проектах.

[QUOTE][B][CASE] Веб-студия Тайм Дизайн снабжает все разработанные веб-проекты пользовательскими инструкциями, созданными в Dr.Explain[/B]
[I]Дмитрий Ничипорчук, владелец и руководитель веб-агентства полного цикла Тайм Дизайн , рассказал о том, чем они отличаются от других веб-студий и как Dr.Explain вот уже несколько лет помогает им в этом.[/I]

[URL=https://www.drexplain.ru/cases/veb-studiya-taym-dizayn-snabzhaet-vse-razrabotannye-veb-proekty-polzovatelskimi-instruktsiyami/]https://www.drexplain.ru/cases/veb-studiya-taym-dizayn-snabzhaet-vse-razrabotannye-veb-proekty-polzovatelskimi-instruktsiyami/[/URL][/QUOTE]


Больше: [[URL=https://www.drexplain.ru/cases/]Кейсы от русскоязычных пользователей[/URL]] [[URL=https://www.drexplain.com/cases/]Кейсы от международных пользователей[/URL]]
[Кейс] Dr.Explain в компании Медиком, С помощью Dr.Explain производитель медицинского оборудования Медиком автоматизировал задачи создания руководств пользователя
 
Продолжаем публикацию серии пользовательских кейсов-примеров использования Dr.Explain в различных компаниях и проектах.

[QUOTE][B][CASE] С помощью Dr.Explain производитель медицинского оборудования Медиком автоматизировал задачи создания руководств пользователя[/B]
[I]Евгений Бояркин, специалист отдела технической поддержки программного обеспечения компании ООО Медиком, рассказал о том, почему важно уделять внимание пользовательской документации и как в этой задаче им помогает программа Dr.Explain.[/I]

[URL=https://www.drexplain.ru/cases/s-pomoshchyu-dr-explain-medikom-avtomatiziroval-zadachi-sozdaniya-rukovodst/]https://www.drexplain.ru/cases/s-pomoshchyu-dr-explain-medikom-avtomatiziroval-zadachi-sozdaniya-rukovodst/[/URL][/QUOTE]


Больше: [[URL=https://www.drexplain.ru/cases/]Кейсы от русскоязычных пользователей[/URL]] [[URL=https://www.drexplain.com/cases/]Кейсы от международных пользователей[/URL]]
Поддержка ГОСТ 34 и 19 в Dr.Explain, Новая фукнциональность для отечественных пользователей - создание руководства пользователя по ГОСТ
 
[SIZE=12pt][B]Начиная с версии 5.5.1100, программа для создания пользовательской документации Dr.Explain предлагает функцию автоматизированной поддержки ГОСТ в проектах.[/B][/SIZE]

Сейчас реализована поддержка самого востребованного типа документа по ГОСТ 34 - [B]“Руководство пользователя”. [/B]

В частности программа Dr.Explain контролирует и автоматизирует поддержку следующих требований стандартов:  [LIST]
[*]Наличие обязательных разделов документа “Руководство пользователя” [ГОСТ 34 РД 50-34.698-90]. Все разделы снабжаются пояснениями по их содержанию.
[*]Оформление титульных листов, аннотации и содержания [ГОСТ 19.105-78, 19.104-78].
[*]Параметры печатных страниц документа и расположение основных элементов на них [ГОСТ 19.106-78].
[*]Структуру и оформление колонтитулов [ГОСТ 19.106-78].
[*]Оформление текстовой части документа: стили шрифтов, абзацные отступы, межстрочные интервалы [ГОСТ 19.106-78].
[*]Формирование и оформление заголовков, разделов, перечислений (списков) [ГОСТ 19.106-78].
[/LIST]

[B]Более подробно о поддержке ГОСТ в Dr.Explain можно прочитать в статье:[/B][B] [/B][URL=https://www.drexplain.ru/articles/razrabotka_rukovodstva_polzovatelya_po_gost_34_i_gost_19_v_programme_dr_explain/][B]Разработка руководства пользователя по ГОСТ 34 и ГОСТ 19 в программе Dr.Explain[/B][/URL]

[I][COLOR=#003562]Мы планируем дальнейшее развитие поддержки государственных и отраслевых стандартов в продукте, поэтому [/COLOR][/I][I][COLOR=#003562]б[/COLOR][/I][I][COLOR=#003562]удем признательны за любые отзывы, комментарии, замечания и пожелания, связанные с[/COLOR][/I][I][COLOR=#003562] новой функциональностью, высказанные здесь или по адресу [URL=mailto:help@drexplain.com]help@drexplain.com[/URL][/COLOR][/I][I][COLOR=#003562]
[/COLOR][/I]

[I][COLOR=#003562]Спасибо.[/COLOR][/I]

Изменено: ''Dr.Explain'' - 20.12.2017 12:11:36
[Кейс] Dr.Explain в компании EasyData, Компания EasyData перешла к использованию Dr.Explain для быстрого создания пользовательской документации в различных форматах
 
Начинаем публикацию серии пользовательских кейсов-примеров использования Dr.Explain в различных компаниях и проектах.

[QUOTE][B][CASE] Компания EasyData перешла к использованию Dr.Explain для быстрого создания пользовательской документации в различных форматах[/B]
[I]Владимир Баранов, генеральный директор компании EasyData, рассказал о том, почему они больше не пишут пользовательскую документацию в Microsoft Word, а перешли на использование Dr.Explain.[/I]

[URL=https://www.drexplain.ru/cases/kompaniya-easydata-pereshla-k-ispolzovaniyu-dr-explain-dlya-sozdaniya-polzovatelskoy-dokumentov/]https://www.drexplain.ru/cases/kompaniya-easydata-pereshla-k-ispolzovaniyu-dr-explain-dlya-sozdaniya...[/URL][/QUOTE]


Больше: [[URL=https://www.drexplain.ru/cases/]Кейсы от русскоязычных пользователей[/URL]] [[URL=https://www.drexplain.com/cases/]Кейсы от международных пользователей[/URL]]
Изменено: ''Dr.Explain'' - 20.12.2017 11:55:56
Онлайн-справки, хорошие примеры онлайн-руководств, на которые надо равняться ))
 
Добрый день,

Некоторые реальные примеры онлайн-справок наших пользователей вы можете посмотреть на этих страницах:

[B]Примеры онлайн-хелпов:[/B]
[URL=https://www.drexplain.ru/help_authoring_samples/]https://www.drexplain.ru/help_authoring_samples/[/URL] (RU)
[URL=https://www.drexplain.com/help_authoring_samples/]https://www.drexplain.com/help_authoring_samples/[/URL] (EN)

[B]Пользовательские кейсы с примерами (не только онлайн-хелпы):[/B]
[URL=https://www.drexplain.ru/cases/]https://www.drexplain.ru/cases/[/URL] (RU)
[URL=https://www.drexplain.com/cases/]https://www.drexplain.com/cases/[/URL] (EN)

Насчет "огненности" - вопрос открыт :) , но надеюсь, почерпнете какие-то идеи для своей документации.

Возможно, вам также будет интересна статья о том, что нужно учесть при публикации онлайн-справки:
[URL=https://www.drexplain.ru/articles/publikuem_onlayn_dokumentatsiyu_na_sayte_proekta/]https://www.drexplain.ru/articles/publikuem_onlayn_dokumentatsiyu_na_sayte_proekta/[/URL]
Вставка видео в Dr.Explain, Подскажите как можно вставить видео?
 
Vita,

А вы можете прислать свой проект и все, что к нему прилагается, на [URL=mailto:help@drexplain.com]help@drexplain.com[/URL]?
Или выложить куда-то и прислать ссылку.

Спасибо.
Некоторые идеи..., Для для дальнейшего развития
 
Вита, полностью с вами согласен.
Функции очень нужные и мы их обязательно реализуем.
Однако, на ближайшие пару месяцев работа уже распланирована, а эти вещи не так просты в реализации.
Поэтому ближайший ориентир, который могу дать по времени - начало осени.
Вставка видео в Dr.Explain, Подскажите как можно вставить видео?
 
Vita, добрый день.

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

Однако, есть способ вставить специальный код для проигрывания вашего файла с вашего сервера.
Для  вставки в Dr.Explain  в текстовом редакторе нажмите на панели   инструментов иконку вставки  видео или нажмите комбинацию горячих клавиш   Ctrl+Shift+V. В окне вставки  видео переключитесь в поле вставки кода и   скопируйте в него следующий  текст:

[B]Вариант 1: [/B]В HTML поддерживаются видео .AVI, .WMV и .MP4. Остальные могут поддерживаться при наличии установленного плагина (например, QuickTime или VLC, в зависимости от браузера). [QUOTE]<object data="[B]my_cool_video.avi[/B]" width="360" height="250">
  <param name="src" value="[B]my_cool_video.avi[/B]" />
  <embed type="video/x-ms-wm" src="[B]my_cool_video.avi[/B]" width="360" height="250"></embed>
</object>
[/QUOTE]
где "my_cool_video.avi" - название видео файла, расположенного в том же  каталоге, что и HTML. В общем случае там должен быть указан путь к  видеофайлу (абсолютный или относительный).


[B]Вариант 2:[/B] В файлах CHM поддерживаются только видео в формате WMV (возможно, в последних обновлениях к Internet Explorer были добавлены другие форматы ). [QUOTE]<object data="[B]winsat.wmv[/B]" classid="CLSID:22d6f312-b0f6-11d0-94ab-0080c74c7e95" codebase="[URL=http://activex.microsoft.com/activex/controls/mplayer/en/nsmp2inf.cab#]http://activex.microsoft.com/activex/controls/mplayer/en/nsmp2inf.cab#[/URL] Version=6,4,7,1112" type="application/x-oleobject" style="border: none;" width="672" height="604">
  <param name="filename" value="[B]winsat.wmv[/B]" />
  <param name="autoplay" value="false" />
  <param name="autostart" value="false" />
  <param name="ShowControls" value="1" />
  <param name="controller" value="true" />
  <param name="WindowlessVideo" value="0" />
</object>
  [/QUOTE]
Замените "winsat.wmv" на название нужного видео файла (только название   файла, без пути к нему т.е. "my_video.wmv" вместо   "C:\Users\Jack\Documents\my_video.wmv"). Обратите внимание, что название   нужно указать в двух местах: в
<object data="winsat.wmv"
и в
<param name="filename" value="winsat.wmv" />
Изменено: ''Dr.Explain'' - 28.08.2017 20:14:40
Несколько вопросов по вставке скриншотов
 
[QUOTE]Vita написал:
Возникла следующая проблема. При сохранении документа: выдал ошибку, закрылся и соответственно вся работа пропала, не сохранил... + Документ, который сохранялся вчера без проблем и открывался без проблем, сегодня тоже выдал ошибку. Что случилось? Как быть?[/QUOTE]
Вита,

1) Пришлите, пожалуйста, проблемный документ на [URL=mailto:help@drexplain.com]help@drexplain.com[/URL]
2) Сохраняли на сетевой диск или удаленный компьютер? Какой размер файла? Какая у вас версия программы? Сохраняли не в момент выключения Windows?
3) Рядом с файлом документа должен быть файл резервной копии ...gui.bak. Переименуйте его, удалив, расширение .bak, и попробуйте открыть его в программе и продолжить работу с ним.
Несколько вопросов по вставке скриншотов
 
[QUOTE]Vita написал:
[QUOTE] ''Dr.Explain'' написал:
Vita, добрый день.


Аннотированный скриншот можно вставить и в уже существующий раздел.

Также можно аннотировать уже существующее изображение.[/QUOTE]
К сожаления, у меня отличается функционал контекстного меню если открывать его на самом изображении, или не возможно воспользоваться: "Добавить из файла и аннотировать" и "Захватить и аннотировать". С чем это может быть связанно?[/QUOTE]

Такое может происходить, если у вас уже есть аннотированный скриншот  в разделе. Пока ограничение в один аннотированный скрин на раздел, к  сожалению, существует.
Несколько вопросов по вставке скриншотов
 
Vita, добрый день.


Аннотированный скриншот можно вставить и в уже существующий раздел.

Также можно аннотировать уже существующее изображение.
Изменено: ''Dr.Explain'' - 10.04.2017 18:18:36
Реклама в пробной версии Dr.Explain
 
Прошу прощения за задержку с ответом на форуме.

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

Насколько я помню, проблема там была достаточно экзотическая. В системе была сброшена ассоциация HTML или XML файлов с м Internet Explorer. Поэтому вместо их молчаливого открытия через IE и обработку пользователя начинали пытать вопросами, как открыть файл.
В итоге все решилось благополучно.
Некоторые идеи..., Для для дальнейшего развития
 
Спасибо за идеи!

Обязательно обсудим их с командой.
Help&Manual или Dr.Explain?, Не могу определиться
 
Добрый день.

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

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

Прошу прощения за задержку с ответом. С форума перестали приходить уведомления о новых темах и постах.

В Dr.Explain есть так называемые Variables (Переменные), хранящие текстовые блоки, которые при итоговой компиляции вставляются в то место, где есть переменная.
Более подробно: [URL=http://www.drexplain.ru/help/variables.php]http://www.drexplain.ru/help/variables.php[/URL]
Dr.Explain как инструмент для создания мобильной версии пользовательской документации, Пользовательская и служебная документация должны быть доступны с мобильных устройств в удобном для работы виде
 
[SIZE=10pt][B][SIZE=12pt]Dr.Explain как инструмент для создания мобильной версии пользовательской документации
[/SIZE][/B][/SIZE]
[SIZE=12pt]Времена, когда документация поставлялась только в виде печатного талмуда или много мегабайтного PDF-файла, прошли. Необходимость публикации документации в Интернет в виде онлайн-справки - неоспоримый факт. И такая онлайн-справка должна быть одинаково удобна в работе как с традиционного настольного ПК, таки и с любого мобильного устройства. Какими факторами обеспечивается это удобство и рассказывается в данной статье.[/SIZE]

[URL=http://www.drexplain.ru/articles/instrument_dlya_sozdaniya_mobilnoy_versii_polzovatelskoy_dokumentatsii/]http://www.drexplain.ru/articles/instrument_dlya_sozdaniya_mobilnoy_versii_polzovatelskoy_dokumentat...[/URL]
Новогодний Зодиак технических писателей, Шутка, а может быть и нет
 
Друзья, в канун новогодних праздников мы решили немного отвлечься от серьезных проектов и немного пошутить на профессиональную тему.  :)

Мы с коллегами составили гороскоп технических писателей. В нем мы выделили сильные черты каждого знака Зодиака и попытались понять, как их можно использовать в профессиональном плане.
Узнать, что ближе всего вашему знаку можно на этой странице: http://www.drexplain.ru/technical-writer-zodiac/

С наступающим вас!
;)
Пусть в вашей работе всегда будет место игре и юмору.
Изменено: ''Dr.Explain'' - 29.12.2015 11:40:11
C Новым годом, друзья!, Поздравляем друг друга с Новым годом! Ура!
 
С новым годом, коллеги.

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

Новая статья на нашем сайте:

[B][SIZE=11pt][SIZE=12pt]Публикуем онлайн-документацию на сайте проекта[/SIZE]
[/SIZE][/B][SIZE=11pt][SIZE=10pt][I]Формат, структура, расположение, оформление и другие нюансы, влияющие на то, как люди будут пользоваться вашей онлайн-документацией и будут ли они ей пользоваться вообще. [/I]
[/SIZE][/SIZE]
[URL=http://www.drexplain.ru/articles/publikuem_onlayn_dokumentatsiyu_na_sayte_proekta/]http://www.drexplain.ru/articles/publikuem_onlayn_dokumentatsiyu_na_sayte_proekta/[/URL]

Всех с наступающим!
10 эвристик для оценки удобства использования (юзабилити) вашей документации, Адаптированный перевод оригинальной статьи: "Tips and Tricks: 10 Heuristics for Evaluating Documentation Usability"
 
Перевели коротенькую практическую статью с сообщества techwhirl.com.
Статья о простых критериях, по которым можно понять, насколько полезна и пригодна к использованию ваша документация.

[B]10 эвристик для оценки удобства использования (юзабилити) вашей документации[/B]
[URL=http://www.drexplain.ru/articles/10_evristik_dlya_otsenki_udobstva_ispolzovaniya_usability_vashey_dokumentatsii/]http://www.drexplain.ru/articles/10_evristik_dlya_otsenki_udobstva_ispolzovaniya_usability_vashey_do...[/URL]

Оригинальный текст был опубликован давно, но в сообществе признали его актуальным и повторно опубликовали на днях.
Мы же просто сделали русский вариант, чтобы донести это знание и до отечественных техписателей.
16 причин, почему ваши пользователи не читают документацию, Поговорим о мифе, что "хелпы не читают".
 
[QUOTE]Виктор Фигурнов написал:

Использование формата встроенной справки CHM считаю крайне нежелательным.  От формата CHM его разработчик (Microsoft) отказался еще в 2002 году, этот формат имеет массу проблем и ограничений.[/QUOTE]
Добрый день, Виктор.
Все так, но до сих пор у этого формата самая универсальная (out of the box) поддержка во всем версиях Windows. Реализация контекстной помощи через HtmlHelp API остается самым простым и "штатным" путем для большинства разработчиков.
16 причин, почему ваши пользователи не читают документацию, Поговорим о мифе, что "хелпы не читают".
 
[B][SIZE=14pt]16 причин, почему ваши пользователи не читают документацию[/SIZE][/B]
[URL=http://www.drexplain.ru/articles/pochemu_imenno_vashi_polzovateli_ne_chitayut_dokumentatsiyu/]http://www.drexplain.ru/articles/pochemu_imenno_vashi_polzovateli_ne_chitayut_dokumentatsiyu/[/URL]
[QUOTE]... документацией к продукту иногда, действительно, не пользуются. В основном, это происходит по следующим причинам...[/QUOTE]

Статья не о программе Dr.Explain и вполне подошла бы и для раздела [B]"Введение в специальность"[/B] этого форума, но, поскольку в ней все-таки есть упоминание нашего продукта, я счел более корректным разместить ее в "нашем" подфоруме.
Страницы: 1 2 3 4 5 6 След.