I find that this big block of comments feels weird here. We should move it up into the docstring of the function itself.