How about the Go style where examples in documentation are actually run as part of the test suite: https://go.dev/blog/examples https://go.dev/blog/examples ?

How about the Go style where examples in documentation are actually run as part of the test suite: https://go.dev/blog/examples https://go.dev/blog/examples ? This way the examples must always be valid and runnable.