In [Rust](https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#documenting-components) there is an expectation that doc strings will include examples. This could be a good idea to start including more and more in our doc strings. Along with this we would need to implement [doctest](https://docs.pytest.org/en/7.1.x/how-to/doctest.html) in pytest. Is this a good paradigm?
