Как у Вас с документацией?

Спустя несколько лет погружения в тестирование, я могу с уверенностью сообщить: документацию писать никто не любит. Мы ее откладываем, планируем на конец дня, когда голова и так уже буквально взрывается, а вспоминаем только когда уже что-то сломалось. Всегда есть дела поинтереснее – например автоматизации тестов. Я бы сказал что документация - снижение хаоса, а не любовь к тексту.

1 причина: Документация экономит время, но не сразу. Позаботьтесь о себе "будущем". Сложная проверка, логика конфигурации, костыли о которых "все знают". А через неделю? Через месяц? Поэтому нужна заметка о том, что делалось и как, а хранить ее можно системно или локально.

2 причина: Это полезно вашей команде В любой команде есть знания, которые нигде не зафиксированы. Каждый усвоил какие-то знания, которые другим коллегам могут быть неочевидны. Например, данные для входа тестовых пользователей или параметры запуска тестовой среды. Если вы знаете - готовьтесь отвечать каждый раз, когда это понадобится. Запишите один раз - перестаньте быть "конфлюенс" для коллег.

3 причина: Меньше шума около команды Вы как тестировщик, вероятно, обладаете самыми подробным и специализированными знаниями о продукте, которых может не быть у других. Чем больше вы задокументируете - тем реже к команде будут вопросы.

4 причина: Меньше слепых зон Представьте функцию с десятками настроек. Для нее будет сотня комбинаций тестов. Часть логики неизбежно выпадет. Не потому что вы слабый специалист, а потому что система большая. Да, документация не гарантирует полноту, но сильно снизит вероятность провала.

5 причина: Эффективный регресс Вспоминаете ли вы весь функционал мгновенно? Сложную и большую систему нереально держать в голове. А без фиксации сценариев и кейсов, регресс со временем упрощается. И проверяется только то. что помнится. Документация возвращает структуру этих регрессов.

Конечно, документация не делает продукт качественным сама по себе. Но она делает ваши процессы предсказуемыми. Обдумайте перечисленные причины. В какой-то момент окажется, что это не "доп работа" или "рутина", а способ не делать работу дважды.

Как у Вас с документацией? | Сетка — социальная сеть от hh.ru Как у Вас с документацией? | Сетка — социальная сеть от hh.ru