Про редизайн документации GitLab GitLab считает, что отличная | Shut up and write
Про редизайн документации GitLab
GitLab считает, что отличная документация для их проекта — это необходимость. Чтобы сделать свою документацию отличной, они провели исследование о том, зачем пользователи приходят в их документацию и что в ней сейчас не так. Проанализировали эти данные и сделали на основе них редизайн сайта документации.
А еще они опубликовали вопросы и результаты исследования, роадмап документации и то, какие решения уже реализовали.
Исследование и его результаты показывают, что в документации важен не только текст, а еще его структура и организация.
Дальше немного красивых циферок и рандомных фактов.
Нашли ли пользователи в документации то, что искали
- 75 % смогли найти.
- 96% из них сказали, что контент полезный.
Пользователям нравится подробная документация с примерами кода.
Зачем пришли в документацию
- 35% искали инструкцию.
- 24% открыли страницу, которую используют как референс.
Большинство пользователей переходят в документацию из Google или сохраненных страниц.
Проблемы, которые выявило исследование
- Трудно найти информацию. Пользователи часто посещают несколько страниц и читают много текста, прежде чем найти нужный контент. Информацию по решению проблем особенно сложно найти.
- Путаница с версиями GitLab. Эта информация появляется в документации в случайном порядке. Пользователи сбиты с толку инструкциями для разных версий продукта на одной странице документации. Новые пользователи не знают, какую версию GitLab они используют.
- Help и Docs разные сайты. Пользователи не видят разницы между двумя сайтами с документацией и не знают, где искать ответ.
- Пользователям нужна помощь в понимании того, какие из многих инструкций лучше для них и почему.
#экспериментыналюдях #makedocumentationgreat