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

This way the examples must always be valid and runnable.