As long as you are touching the doc-string can you re-write it in the numpy-doc style?