good example of an overview doc, from twitter thread on benefit of higher level docs rather than docstring and type annotations only