Transform examples in docs into included source files

[hynek]

A successful examples of this is https://github.com/hynek/svcs/tree/main/docs/examples

We’ve had the case of errors in recipes before and we’ve hit a similar dilemma in #817 again. Source code that isn’t a doctest should still be somehow verifiable.

cc @sirosen