[Experiment]: Behaviour Driven Developement and Living Documentation

[philou]

Contact Details

philippe.bourgau@gmail.com

Feature Request

We repeatedly need to explain to new users who want to use TCR for training or in real life how it works and what we can expect out of it.

Feature Description

Use human-readable tests that we can also use as documentation for the main scenarios of TCR.

We could go with Gherkin, or something else.

Learn and decide what to do next

Alternatives

• classic unit tests
• keep it as it is
• add non-executable documentation

Additional Context

There are different ways to implement this:

• GoDog 8a0f55e
• Literate programming test converter 971f997
• Living doc with asciidoc and Approvals (sfauvel/doc_as_test_workshop: Workshop to experiment Doc as Test (github.com))

This experiment could also lead to coaching content

Code of Conduct

• I agree to follow this project's Code of Conduct