Тестирование документации: залог успешной разработки
Когда создаётся программное обеспечение, важно не только писать код, но и грамотно описывать, что этот код должен делать. Для этого существуют требования — это такая "карта", по которой разработчики и тестировщики понимают, что именно нужно создать. Если эта карта написана с ошибками или слишком запутанно, можно приехать совсем не туда, куда планировали.
Почему важно проверять документацию заранее?
Представьте, что вы собираетесь строить дом. У вас есть план, но если он неполный или в нём ошибки, вместо уютного дома может получиться что-то с одной стеной или без крыши. В программировании примерно так же: если требования, то есть документация, составлены плохо, программа может не работать или работать неправильно.
Проверка требований до начала разработки помогает находить проблемы раньше, чем они превратятся в баги. Чем раньше найдёшь ошибку, тем меньше потом придётся исправлять. Это называется "Shift-Left Testing", что по сути означает — тестировать раньше, чтобы потом не было больно.
Вот какие проблемы можно найти на этом этапе:
Противоречия в требованиях: например, в одном месте написано "сохранить данные", а в другом — "удалить данные". Так какой из них правильный?
Неоднозначные формулировки: когда написано так, что можно понять по-разному, и каждый разработчик это понимает по-своему.
Отсутствие важных условий: что-то важное просто забыли описать, и программа не знает, что с этим делать.
Ошибки в сценариях использования: не описаны крайние случаи, например, что делать, если пользователь ввёл неправильные данные.
Как можно тестировать требования?
Есть несколько способов проверить, что в документации нет ошибок:
Формальная проверка: использование строгих правил, чтобы убедиться, что всё написано правильно.
Чтение и обсуждение: собираемся, читаем вместе, обсуждаем и находим проблемы.
Моделирование: создаём простые схемы, чтобы понять, как всё должно работать.
Анализ текста с помощью ИИ: современные программы могут сами искать ошибки в тексте требований.
Что будет дальше?
Ниже можете видеть видео, где видно, как наш инструмент TestWriter проводит проверку документации с помощью ИИ. Это пока что прототип, но уже видно, как много ошибок можно найти ещё до начала разработки.
Полезные материалы по теме:
Тестирование требований — Teamlead Roadmap: Простое объяснение, зачем проверять требования перед началом разработки.
Критерии качества требований с примерами — Habr: Примеры, как сделать документацию понятной и понятной для всех.
Тестовая документация: что учитывать при постановке эффективного процесса тестирования — Habr: Как правильно описывать требования, чтобы не возникало путаницы.
Роль формализации требований в тестировании программного обеспечения — КиберЛенинка: Почему важно прописывать требования максимально чётко.
Тестирование требований — Особенности — Quality Lab: Как работают с требованиями на практике и какие ошибки бывают.
P.S.: а вот ссылка на мой блог в Telegram: https://t.me/it_vadimqa