vanessa-automation icon indicating copy to clipboard operation
vanessa-automation copied to clipboard

Добавить в документацию "best practices" по написанию понятных и стабильно работающих фич

Open ovcharenko-di opened this issue 2 years ago • 3 comments

За основу можно взять такой чек-лист. К нему можно добавить примеры "хорошо" и "плохо" с пояснением почему.

  • Правильно ли указаны Ид задач
  • Правильно ли описана секция "Функционал"
  • Правильно ли организована работа сценария в разделе "Контекст"
    • подключение тест клиентов
    • закрытие всех окон
  • Правилен ли сам сценарий
    • проверяет ли сценарий то, что должен проверять
    • достаточно ли сценарий изолирован
    • нет ли избыточных шагов
    • нет ли лишних колонок в шагах сравнения таблиц
    • используются ли библиотечные шаги там, где их необходимо использовать
    • шаги сценария сгруппированы так, что 1-2 уровни дерева точно передают его смысл
    • нет ли в сценарии тестовых или потенциально неуникальных значений («Контрагент1» и «ТестоваяНоменклатура»)
    • в сценарии должны использоваться термины и выражения, соответствующие конфигурации (например, документ с синонимом "Задание на смену" в сценарии надо называть именно "Задание на смену", а не "Задание работнику по смене")
  • Правильно ли использованы шаги
    • в полях ссылочного типа необходимо использовать "я выбираю по строке", а не выбор точного значения
    • в полях перечислений необходимо выбирать точное значение

Способы повышения "надежности" сценариев:

  • вместо выбора значений из форм списка лучше использовать ввод по строке
  • приводить форму к стандартным настройкам, если в сценарии она изменялась

Способы повышения читаемости сценариев:

  • группировка шагов

Способы связи сценариев с требованиями и задачами в трекере:

  • feature mapping??
  • теги @issue=11111 + (Allure properties?)

ovcharenko-di avatar Nov 09 '21 08:11 ovcharenko-di

Супер! Отличная идея!

Pr-Mex avatar Feb 19 '22 10:02 Pr-Mex

Я вот тут начинал делать описание практик, которые мы у себя используем/должны использовать. https://stepa86.github.io/About-tests-in-1C/BDD/best_practices/01_blocks/ Но у меня времени не хватает на актуализацию. И это наши "стандарты", они могут сильно не совпадать со "стандартами" у других команд, поэтому неизбежны холивары. Я против не буду, если что-то заиспользуете.

Stepa86 avatar Feb 21 '22 12:02 Stepa86

@Stepa86 Ага, спасибо!

Pr-Mex avatar Feb 21 '22 18:02 Pr-Mex