Switch from documenting class.__init__ from the class docstring to the __init__ docstring

[andrrizzi]

Numpy-style documentation suggests to document the constructor in the class docstring. However, because of how sphinx renders the class API docs, I think it's more readable to move the description in __init__'s docstring.