Examples put in @return like this tend to render oddly when generated. Can we slide this up to the main docstring and then refer to it down here?