[Stepik] Тестирование документации - тестирование требований (Юлия Горшкова)

​

Тестирование документации — это не формальность и не финальный штрих, а важная часть качества продукта, значительно удешевляющая процесс разработки ПО.
Этот курс создан для начинающих и работающих тестировщиков уровня джуниор и миддл, которые хотят уверенно проверять требования, пользовательские сценарии, API-спецификации и сопроводительные материалы.
Мы последовательно разберём, как читать документы так, чтобы находить противоречия, неопределённости и пробелы, как соотносить документацию с реальным поведением системы и как выстраивать трассируемость между требованиями и тестами.
К окончанию курса вы сможете уверенно проверять документацию разных типов, фиксировать замечания аргументированно и конструктивно, поддерживать трассируемость и влиять на качество продукта ещё до написания кода.
Вы научитесь выстраивать предсказуемый процесс ревью, экономить время команды и снижать стоимость исправления дефектов за счёт раннего обнаружения проблем в документах.

Для кого этот курс

• Тестировщики начального уровня, которые хотят понять, с чего начинать проверку документации и как не упускать важные детали.
• Тестировщики уровня миддл, которым нужна структура, чёткие критерии и расширение набора техник для ревью документов.
• Инженеры по качеству, участвующие в анализе требований, уточнении сценариев и приёмке изменений по API.

Чему вы научитесь

• Определять цели и границы тестирования документации, выбирать правильные источники истины и договариваться о критериях качества.
• Применять чек-листы качества к требованиям: полнота, непротиворечивость, однозначность, проверяемость, актуальность, трассируемость.
• Разбирать пользовательские сценарии: основной поток, альтернативы, исключения, предусловия и постусловия, а также переводить их в тестовые идеи и наборы.
• Читать и проверять спецификации API на основе Swagger или OpenAPI: схемы, типы, обязательные поля, коды ошибок, примеры, версии и обратная совместимость.
• Строить карту трассируемости между требованиями, тестами, багами и релизами, поддерживать её в актуальном состоянии и использовать для анализа регрессии.
• Тестировать интерфейсные тексты и локализацию: единообразие терминов, тональность, длины строк, переносы,Plural-формы, форматы даты, времени и чисел, а также доступность.
• Работать с версиями и процессом согласования изменений: ревью, комментарии, фиксация решений, контроль изменений и связь с задачами.
• Использовать инструменты: системы документации как код, линтеры, статический анализ, средства для сравнения версий и автоматической генерации документации.

Спойлер: Программа курса

Роль и основы тестирования документации:

1. Зачем тестировать документацию
2. Виды документации: от требований до пользовательских гайдов
3. Источники истины и артефакты проекта
4. Область ответственности тестировщика при ревью документов
5. Базовый чек-лист качества и типичные дефекты

Требования и критерии качества документации:

1. Полнота, непротиворечивость, однозначность, проверяемость.
2. Нефункциональные требования и качественные атрибуты.
3. Примеры плохих формулировок и как их исправлять.
4. Приоритеты и риск-ориентированное ревью.
5. Критерии готовности документа к разработке.

Пользовательские сценарии: юзкейсы и сториз:

1. Структура юзкейсов: акторы, предусловия, основной и альтернативный сценарии.
2. User Story, критерии приёмки и Definition of Ready.
3. Негативные сценарии и исключения.
4. От сценария к тестовым идеям и наборам.
5. Проверка согласованности сценариев между собой.

Спецификации API: Swagger и OpenAPI

1. Структура спецификации: схемы, операции, модели и примеры.
2. Обязательные и необязательные поля, типы и валидация.
3. Коды ответов, ошибки и согласованность контрактов.
4. Обратная совместимость и версии API.
5. Проверка примеров и соответствия схеме.

Трассируемость: маппинг тестов на документацию

1. Матрица трассируемости: требования, тесты, дефекты, релизы.
2. Методика покрытия: что и как связывать.
3. Актуальность связей и контроль изменений.
4. Метрики покрытия и риск-ориентированный подход.
5. Практика анализа влияния изменений.

Проверка интерфейсных текстов и локализации

1. Единообразие терминов и тональность.
2. Ограничения длины, переносы и усечение.
3. Форматы даты, времени, чисел и валют.
4. Плюральные формы и гендерные конструкции.
5. Доступность и читабельность текстов.

Версионирование, изменения и согласования

1. Процесс ревью документации и фиксация решений.
2. Версионирование и политика изменений.
3. Семантическое версионирование и обратная совместимость.
4. Контроль изменений и аудит следов.
5. Работа с фичефлагами и временной расхождением дока и кода.

Заключение

1. Антипаттерны и профилактика дефектов в документации.
2. Как подготовиться к встрече «Трес Амигос».
3. Тестировщик на груминге.