I think rspec's Cucumber docs are fine. https://relishapp.com/rspec/rspec-expectations/v/3-8/docs/built-in-matchers/equality-matchers https://relishapp.com/rspe

I think rspec's Cucumber docs are fine. https://relishapp.com/rspec/rspec-expectations/v/3-8/docs/built-in-matchers/equality-matchers https://relishapp.com/rspec/rspec-expectations/v/3-8/docs/bu... It's an executable specification, but it's also in a format which is readable. If not "documentation", then it's at least "small, verified examples". I'd find a table of values less readable. I don't mind if a document like this is the output of running the tests themselves, though. (Obviously, the important details are "input program, expected output", which might not lead you to use Cucumber, but I think it's a fine use of Cucumber).