Тестирование документации — это не формальность и не финальный штрих, а важная часть качества продукта, значительно удешевляющая процесс разработки ПО.
Этот курс создан для начинающих и работающих тестировщиков уровня джуниор и миддл, которые хотят уверенно проверять требования, пользовательские сценарии, API-спецификации и сопроводительные материалы.
Мы последовательно разберём, как читать документы так, чтобы находить противоречия, неопределённости и пробелы, как соотносить документацию с реальным поведением системы и как выстраивать трассируемость между требованиями и тестами.
К окончанию курса вы сможете уверенно проверять документацию разных типов, фиксировать замечания аргументированно и конструктивно, поддерживать трассируемость и влиять на качество продукта ещё до написания кода.
Вы научитесь выстраивать предсказуемый процесс ревью, экономить время команды и снижать стоимость исправления дефектов за счёт раннего обнаружения проблем в документах.
Для кого этот курс
- Тестировщики начального уровня, которые хотят понять, с чего начинать проверку документации и как не упускать важные детали.
- Тестировщики уровня миддл, которым нужна структура, чёткие критерии и расширение набора техник для ревью документов.
- Инженеры по качеству, участвующие в анализе требований, уточнении сценариев и приёмке изменений по API.
Чему вы научитесь
- Определять цели и границы тестирования документации, выбирать правильные источники истины и договариваться о критериях качества.
- Применять чек-листы качества к требованиям: полнота, непротиворечивость, однозначность, проверяемость, актуальность, трассируемость.
- Разбирать пользовательские сценарии: основной поток, альтернативы, исключения, предусловия и постусловия, а также переводить их в тестовые идеи и наборы.
- Читать и проверять спецификации API на основе Swagger или OpenAPI: схемы, типы, обязательные поля, коды ошибок, примеры, версии и обратная совместимость.
- Строить карту трассируемости между требованиями, тестами, багами и релизами, поддерживать её в актуальном состоянии и использовать для анализа регрессии.
- Тестировать интерфейсные тексты и локализацию: единообразие терминов, тональность, длины строк, переносы,Plural-формы, форматы даты, времени и чисел, а также доступность.
- Работать с версиями и процессом согласования изменений: ревью, комментарии, фиксация решений, контроль изменений и связь с задачами.
- Использовать инструменты: системы документации как код, линтеры, статический анализ, средства для сравнения версий и автоматической генерации документации.
Программа курса
Роль и основы тестирования документации
- Зачем тестировать документацию
- Виды документации: от требований до пользовательских гайдов
- Источники истины и артефакты проекта
- Область ответственности тестировщика при ревью документов
- Базовый чек-лист качества и типичные дефекты
Требования и критерии качества документации
- Полнота, непротиворечивость, однозначность, проверяемость.
- Нефункциональные требования и качественные атрибуты.
- Примеры плохих формулировок и как их исправлять.
- Приоритеты и риск-ориентированное ревью.
- Критерии готовности документа к разработке.
Пользовательские сценарии: юзкейсы и сториз
- Структура юзкейсов: акторы, предусловия, основной и альтернативный сценарии.
- User Story, критерии приёмки и Definition of Ready.
- Негативные сценарии и исключения.
- От сценария к тестовым идеям и наборам.
- Проверка согласованности сценариев между собой.
Спецификации API: Swagger и OpenAPI
- Структура спецификации: схемы, операции, модели и примеры.
- Обязательные и необязательные поля, типы и валидация.
- Коды ответов, ошибки и согласованность контрактов.
- Обратная совместимость и версии API.
- Проверка примеров и соответствия схеме.
Трассируемость: маппинг тестов на документацию
- Матрица трассируемости: требования, тесты, дефекты, релизы.
- Методика покрытия: что и как связывать.
- Актуальность связей и контроль изменений.
- Метрики покрытия и риск-ориентированный подход.
- Практика анализа влияния изменений.
Проверка интерфейсных текстов и локализации
- Единообразие терминов и тональность.
- Ограничения длины, переносы и усечение.
- Форматы даты, времени, чисел и валют.
- Плюральные формы и гендерные конструкции.
- Доступность и читабельность текстов.
Версионирование, изменения и согласования
- Процесс ревью документации и фиксация решений.
- Версионирование и политика изменений.
- Семантическое версионирование и обратная совместимость.
- Контроль изменений и аудит следов.
- Работа с фичефлагами и временной расхождением дока и кода.
Заключение
- Антипаттерны и профилактика дефектов в документации.
- Как подготовиться к встрече «Трес Амигос».
- Тестировщик на груминге.
