DrExplain :: документируем хорошо
41 subscribers
102 photos
11 videos
76 links
Dr.Explain - RU :: Русскоязычный канал о редакторе документации
Download Telegram
Техпис-удаленщик — зло или благо?

Удалёнка убивает качество документации?
Правда ли, что технический писатель, работая из дома, теряет связь с продуктом и командой? Или это путь к максимальной продуктивности?

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

https://www.drexplain.ru/articles/tekhpis_udalenshchik_zlo_ili_blago/

#ПользовательскаяДокументация #DrExplain
Нужен ли техпис в 2026 году?

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

https://www.drexplain.ru/articles/zamenit_li_ii_tekhnicheskogo_pisatelya_v_2026_godu/

#ПользовательскаяДокументация #DrExplain
👍3
Media is too big
VIEW IN TELEGRAM
Dr.Explain 7 — это глобальное обновление программы, в котором повышена производительность и оптимизирован интерфейс.

Работать стало еще приятнее и удобнее: меньше отвлекающих элементов — больше концентрации на содержании.

Посмотрите, как легко создать онлайн версию пользовательской документации привычными инструментами в современном дизайне Dr.Explain 7.

#ПользовательскаяДокументация #DrExplain
Media is too big
VIEW IN TELEGRAM
Формат CHM все еще остается востребованным для разработки пользовательской документации. В следующем видео мы покажем, как быстро и легко создать файл справки в Dr.Explain 7.

#ПользовательскаяДокументация #DrExplain
Media is too big
VIEW IN TELEGRAM
Настройка внешнего вида пользовательской документации помогает расставить акценты и сделать материал по-настоящему дружелюбным к читателю.

В следующем видео мы покажем, как настроить дизайн онлайн-документации в Dr.Explain 7.

#ПользовательскаяДокументация #DrExplain
Media is too big
VIEW IN TELEGRAM
Зачем нужно печатное руководство пользователя, если есть онлайн версия? Оно превращает хорошую документацию в идеальную справочную систему: цифровая версия — для скорости, бумажная — для надёжности. Это дополняющие друг друга источники информации.

Смотрите, как быстро создать готовое к печати руководство пользователя в Dr.Explain 7.

#ПользовательскаяДокументация #DrExplain
This media is not supported in your browser
VIEW IN TELEGRAM
Dr.Explain обновился: работа программы ускорилась, привычные инструменты стали удобнее, а интерфейс приятнее и проще. Посмотрите, как легко аннотировать скриншоты в улучшенной версии Dr.Explain 7.

#ПользовательскаяДокументация #DrExplain
🔥1
Docs as Code — модный тренд или реальная необходимость? Разобрали плюсы и минусы метода, примеры его использования в разработке пользовательской документации.

Кому Docs as Code подходит, а кому стоит продолжить работать с привычными инструментами?

https://www.drexplain.ru/articles/nuzhen_li_docs_as_code_dlya_razrabotki_polzovatelskoy_dokumentatsii_v_2026_godu/

#ПользовательскаяДокументация #DocsAsCode #DrExplain
HelpNDoc или Dr.Explain: что выбрать для создания пользовательской документации?

Два ветерана рынка Help Authoring Tools (оба с 2004 года) пошли разными путями. HelpNDoc сделал ставку на ИИ-агента. Dr.Explain углубился в автоматическую аннотацию.

Чей козырь сэкономит ваш главный ресурс — время?

В новой статье вы узнаете:

о ключевых отличиях программ
о реальных примерах использования и зонах отказа
о сценариях использования
и тд.

https://www.drexplain.ru/articles/helpndoc_ili_dr_explain_chto_vybrat_tekhnicheskomu_pisatelyu_v_2026/

#ПользовательскаяДокументация #DrExplain
Adobe RoboHelp или Dr.Explain?

Рассмотрим на должность техписа двух кандидатов.

👨‍💼Первый: сноб, но обоснованно. Говорит на языке "экосистем", "омниканальности" и "микроконтента". Замечен в связях с ИИ-агентами. Попроси его построить дом — сваяет ЖК с вертолетной площадкой, бункером на случай ядерной войны и блэкджеком со всеми удобствами (еще вопрос, кто кого нанимает).

Инвесторы будут в восторге!

👨‍🔧 Второй: ведущий инженер "из соседнего отдела". Визуал, предпочитает старые, но проверенные стандарты. Полиглот и адепт Windows. Значится в списках Минцифры РФ. Обладает шаблонным мышлением в лучшем смысле этого слова.

Импортозамещен — значит, вооружен!

Кто идеально впишется в вашу организацию? Выбираем по ссылке 👇

https://www.drexplain.ru/articles/sravnenie_instrumentov_dlya_sozdaniya_spravochnykh_sistem_adobe_robohelp_i_dr_explain/

#ПользовательскаяДокументация #AdobeRoboHelp #RoboHelp #DrExplain
👍1
Как создать ИИ-агента для работы с пользовательской документацией?

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

Он будет
распределять контент по логическим файлам и папкам;
оформлять содержимое файлов в формате Markdown;
исправлять стиль, унифицировать термины
и т.д.

https://www.drexplain.ru/articles/kak_sozdat_ii_agenta_dlya_polzovatelskoy_dokumentatsii_v_2026_godu/

#нейронка #AI #ИИ #ИиАгент #ПользовательскаяДокументация #DrExplain
TechWriter Days /3 (2026): конференция фиксирует трансформацию профессии

Знаете, о чём почти не говорили на недавней TechWriter Days /3? О грамотности и стилистике. Докладов о редактировании было мало — зато о семантической разметке, ИИ, CI/CD и автогенерации changelog'ов обсуждений было много.

Главный вывод мероприятия: технический писатель превращается в Document engineer.

В следующей статье со ссылками на доклады вы узнаете:

Как меняются инструменты, цели и подходы к работе техписа?
В чем заключается суть трансформации в Document engineer?

👇
https://www.drexplain.ru/articles/tekhnicheskiy_pisatel_vs_document_engineer_transformatsiya_professii_v_2026/

#TechWriterDays #ПользовательскаяДокументация #DrExplain
Расширенный поиск в HTML-файлах в Dr.Explain

Новый поиск повышает удобство и эффективность работы со справочной системой.

Улучшенное ранжирование результатов поиска.
Улучшенные результаты поиска по документации с большим количеством разделов.
Поддержка синонимов и словоформ.
Поддержка языка поисковых запросов.
Фрагменты результатов поиска (сниппеты) с выделением совпадений.

Подробности 👇
https://www.drexplain.ru/help/advanced_search.php

#ПользовательскаяДокументация #DrExplain
Формулировка "космические стандарты" часто понимается, как запредельная сложность. Однако за ней скрывается не столько трудность технической реализации, сколько предельная дисциплина процессов и грамотное сочетание фундаментального опыта с новыми технологиями.

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

https://www.drexplain.ru/articles/missiya_artemis_ii_chto_mozhet_pocherpnut_tekhpis_v_2026_godu/

#ПользовательскаяДокументация #DrExplain #ИИ #hat
Как подготовить документацию к включению в Реестр отечественного ПО?

Часть отказов в регистрации в Реестре отечественного ПО связана с недоработками в пользовательской документации. Подготовили инструкцию с чек-листом и рекомендациями, соответствующими требованиям Минцифры.

https://www.drexplain.ru/articles/kak_proyti_ekspertizu_mintsifry_v_2026_godu_instruktsiya_po_podgotovke_dokumentatsii/

#ПользовательскаяДокументация #DrExplain #ИИ #hat
Как создать ИИ-агента для аннотирования веб интерфейса?

Продолжаем знакомство с возможностями нейросетей. В следующей статье мы с помощью GitHub Actions создадим ИИ-агента, который

аннотирует скриншот страницы;
дополняет его текстовым файлом с перечислением пронумерованных элементов.

https://www.drexplain.ru/articles/kak_sozdat_ii_agenta_dlya_annotirovaniya_veb_interfeysa/

#нейронка #AI #ИИ #ИиАгент #ПользовательскаяДокументация #DrExplain #GitHubActions
Как перенести разработку пользовательской документации на отечественный софт?

Если вы разрабатываете пользовательскую документацию с помощью зарубежного ПО, самое время разобраться, как выполнить требования законодательства и перейти на отечественные HAT с минимальными потерями.

В новой статье вы узнаете:
как провести аудит текущей документации и не потерять данные при переносе;
как не попасть в типичные ловушки (от битых ссылок до рассинхронизации команд);
как выглядит техническая сторона процесса: экспорт из старой системы, пост-миграционная проверка
и тд.
👇
https://www.drexplain.ru/articles/perenos_polzovatelskoy_dokumentatsii_na_rossiyskie_hat_poshagovoe_rukovodstvo_po_migratsii_2026/

#ПользовательскаяДокументация #DrExplain #HAT
Оцениваем эффективность пользовательской документации

Многие думают, что если обращений в техническую поддержку мало — значит, справочная система спроектирована и написана идеально. Но так ли это на самом деле?

В новой статье разбираем "второй интерфейс" продукта с точки зрения метрик и психологии:

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

и тд.
👇
https://www.drexplain.ru/articles/kak_ponyat_chto_polzovatelskaya_dokumentatsiya_rabotaet/

#ПользовательскаяДокументация #DrExplain #HAT
Что нужно знать техпису о нейросетях в 2026 году?

В новом материале рассматриваем ключевые области знаний, которые превратят технического писателя в специалиста по LLM.

Вы узнаете:

Фундаментальные механизмы больших языковых моделей.
Что такое "промпт-инжиниринг"?
Сравнение и выбор языковых моделей.
и тд.

👇
https://www.drexplain.ru/articles/kak_stat_ekspertom_po_neyrosetyam_v_2026_godu_fundamentalnye_znaniya_dlya_tekhnicheskogo_pisatelya/

#ПользовательскаяДокументация #DrExplain #HAT #ИИ #техпис
Культурный код китайской документации

КНР запускает ракеты, создаёт квантовые компьютеры и захватывает рынок электромобилей. Однако бытует мнение, что хотя технологии улетели в будущее, документация застряла в прошлом: справочные системы здесь по-прежнему непонятные, перегруженные и нечитаемые. Так ли это?

В новой статье вы узнаете:

Почему пользователи в КНР игнорируют официальные гайды и бегут за ответами в WeChat?
Что заставляет местных техписов смягчать прямые запреты в инструкциях?
Как писать документацию, если вам нужно вывести продукт на китайский рынок?

Подробнее 👇

https://www.drexplain.ru/articles/kulturnyy_kod_kitayskoy_dokumentatsii/

#ПользовательскаяДокументация #DrExplain #HAT #техпис