issue_comments: 674491988

This data as json

html_url issue_url id node_id user created_at updated_at author_association body reactions performed_via_github_app issue
https://github.com/pydata/xarray/issues/4345#issuecomment-674491988 https://api.github.com/repos/pydata/xarray/issues/4345 674491988 MDEyOklzc3VlQ29tbWVudDY3NDQ5MTk4OA== 14371165 2020-08-16T07:30:14Z 2020-08-16T07:30:14Z MEMBER

Yeah, I've read the same thing that either __init__ or the class can be used. I liked adding it in __init__ too when I've developed classes because it's consistent with other functions and methods. But now that I'm on the user side I think the class docstring is the way to go. Pandas and scipy seems to be pretty consistent with this as well: * Series - https://github.com/pandas-dev/pandas/blob/v1.1.0/pandas/core/series.py#L139-L4979 * Interpolate- https://github.com/scipy/scipy/blob/v1.5.2/scipy/interpolate/interpolate.py

The Spyder help pane simply reads xr.Dataset.__doc__ and it would correctly read the __init__ doc if I I typed out xr.Dataset.__init__ too, but which users prefers to do that? 

{
    "total_count": 0,
    "+1": 0,
    "-1": 0,
    "laugh": 0,
    "hooray": 0,
    "confused": 0,
    "heart": 0,
    "rocket": 0,
    "eyes": 0
}
   679575175