Use named tuples for returns in documentation

These are pre-existing in named_tuples.py and are already used elsewhere, so
we should use them in the documentation as well.

A pleasant side-effect is that napoleon is much happier to parse these.