specflow с онлайн-документацией

Я хотел бы представить некоторые подходы "исполняемых спецификаций" в моей компании (.NET). я хотел бы продолжать работать со SpecFlow, потому что я действительно убежден, что Gherkin-отличный инструмент. Я бы хотел, чтобы тестовый движок мог разместить эту живую документацию на wiki, чтобы она была видна деловым людям и другим заинтересованным сторонам. Хорошим вариантом должно быть добавление некоторых комментариев к сценариям, чтобы сделать их максимально удобными для пользователя.

Как бы вам это удалось ? У меня есть слышал о Fitnesse или StoryTeller, но, похоже, они не справляются с корнишонами. Или я ошибаюсь ?

1 3
.net bdd specflow specifications

1 ответ:

Возможно, вы захотите взглянуть на соленые огурцы. Пиклз-это генератор живой документации, который преобразует ваш .файлы функций в html-страницы (или документ Word или Excel). Вы можете разместить эти html-страницы на внутреннем веб-сервере.

Я не совсем понимаю, что вы подразумеваете под "добавлением некоторых комментариев".

  • Если вы имеете в виду "добавить некоторые комментарии к живой документации": вы, конечно, можете редактировать html-файлы, но эти изменения будут потеряны при регенерации живой документации. документация. Эти изменения не будут отправлены в систему .и файлы функций тоже.
  • Если вы имеете в виду" добавить некоторые комментарии, чтобы читатели документации имели больше информации, чем просто заданные шаги/when/then": Gherkin позволяет писать описание в начале файла функций и в начале каждого сценария. Кроме того, Gherkin позволяет писать технические комментарии по предыдущим строкам с #. Маринованные огурцы всегда будут отображать описания (markdown поддерживается!) и необязательно визуализировать технические замечания.

Полное раскрытие: я-хранитель соленых огурцов. Если вам нужна помощь, чтобы начать работу с солеными огурцами, не стесняйтесь спрашивать!

4