Техническое писательство
Поделиться:
Вопросы из этого раздела мы задавали только тем, кто занимается написанием технической документации.
12% участников опроса ответили, что занимаются разработкой технической документации, однако лишь 9% сообщили, что это официально входит в их должностные обязанности.
Отвечая на вопрос о должностных обязанностях, можно было выбрать несколько вариантов ответа.
По сравнению с прошлым годом количество разработчиков, которые пишут документацию для пользователей, увеличилось на 5 процентных пунктов.
Подход «документация как код» набирает популярность: все больше людей (на 6 процентных пунктов больше, чем в 2021 году) используют для создания документации инструменты для разработки.
Markdown остается самым популярным языком разметки, а 13% технических писателей используют для него разные расширения.
Повторно используют созданный контент 80% респондентов, при этом треть до сих копирует его вручную.
6%
тех, кто пишет документацию, автоматизируют ее проверки. Чаще всего используются проверки на ошибки разметки, внешних ссылок и примеров кода. Интересно, что 10% используют также автоматические проверки языка.
58%
респондентов ответили, что им нужно документировать API, при этом 61% создают документацию API автоматически. Обычно для этого используется Swagger.
30%
автоматизируют повторяющиеся операции, настраивая шаблоны. Обычно таким образом автоматизируется создание различных тем, документов и повторяющегося контента.
47%
тех, кто использует шаблоны, создают параметризованные шаблоны.
Среди самых распространенных языков с большим отрывом лидирует английский. На втором месте — китайский, но его доля намного меньше.
68%
технических писателей рассматривали возможность использования специального инструмента для написания технической документации.
13% респондентов, пишущих техническую документацию, уже переводят ее на другие языки, а еще 10% планируют этим заняться.
WritersideРанний доступ
Вы относитесь к тем 68%, кто рассматривает возможность использования специального инструмента для написания технической документации?
Присоединяйтесь к программе раннего доступа, чтобы попробовать Writerside:
- работает с IDE на платформе IntelliJ;
- поддерживает Markdown, семантическую разметку и их сочетание;
- предлагает более 100 встроенных тестов для автоматического контроля качества документации;
- поддерживает повторное использование контента с помощью условий и переменных;
- имеет встроенные шаблоны для разных типов контента и сложных элементов разметки.
Спасибо, что уделили время!
Если результаты исследования показались вам интересными, поделитесь ими с друзьями и коллегами.
Если у вас есть вопросы или пожелания, свяжитесь с нами по адресу surveys@jetbrains.com.