Perhaps a practical example like this would be good to have in the
docstring?