[docstest](https://docs.python.org/3/library/doctest.html) is a nice way of checking examples in function signatures. Some of the docs have examples but we could benefit from them as tests.