cleanup docs
get rid of doc warnings
additional numpydocs + napoleon fixes

The last line of a multiline description for Attributes, Returns
Parameters needs to be longer than previous lines !?!
Merge pull request #437 from crbates/docs2

More docs warnings cleanup