well I prefer some high level "unit-tests" (ofc they are not unit tests strictly speaking).

or perhaps I should name them "demo cases" or the like. Currently I am deeply sceptical about formats different from source code. "demo cases" require the dev to update them when they fail where as docs tend to get stale- (nearly) always.