That's fair.  I've moved the gory details to a comment as suggested, and inserted a slightly tweaked version of your suggested text into the docstring.