Тестировали ли документацию
Что проверяют
Считаете ли вы документацию частью продукта. Ответ показывает зрелость: инженер, который проверяет только код, пропускает целый класс дефектов, доходящих до пользователя и до поддержки. Заодно смотрят, знаете ли вы, что требования это тоже документация и тестируются они до написания кода.
Как отвечать
Разделите документацию на слои, по каждому свои проверки.
- Требования и спецификации: раннее тестирование, оно же ревью. Ищете противоречия, неоднозначные формулировки, отсутствие критериев приёмки, неописанные негативные сценарии. Дефект, найденный здесь, стоит дешевле всего.
- Пользовательская документация и подсказки в интерфейсе: пройти сценарий строго по инструкции на чистом окружении. Расхождения всплывают сразу: кнопка переименована, шаг пропущен, скриншот от прошлой версии.
- Документация API: контракт проверяется автоматически. Схема прогоняется валидатором, примеры запросов исполняются, ответы сверяются со схемой. Расхождение реального ответа и описания это такой же дефект, как упавший тест.
- Тестовая документация: чек-листы и тест-кейсы тоже устаревают, ревью чужих кейсов перед регрессом экономит время всей команде.
Назовите критерии, по которым оцениваете текст: полнота, актуальность версии, непротиворечивость, проверяемость, воспроизводимость шагов. И скажите, как оформляете находки: обычным дефектом с указанием страницы и ожидаемого текста, а не сообщением в чате, иначе правка теряется.
Где спотыкаются
Приносят заготовленную историю успеха с эффектом вроде «сократили обращения в поддержку». Проверить это нельзя, звучит шаблонно, а следующий вопрос про детали процесса чаще всего остаётся без ответа.
Второе: сводят всё к вычитке орфографии. Главное в документации не грамотность, а соответствие реальному поведению системы и полнота сценариев.
Третье: проверяют инструкцию на своей машине, где продукт настроен, аккаунт создан и права выданы. Инструкция пишется для человека с нуля, поэтому проходить её надо на чистом окружении новым пользователем, иначе пропущенный шаг установки так и не всплывёт.