We don't need all this detail in the docstring.  Move it to the implementation section.