issue_comments: 618338469

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/3361#issuecomment-618338469 https://api.github.com/repos/pydata/xarray/issues/3361 618338469 MDEyOklzc3VlQ29tbWVudDYxODMzODQ2OQ== 14808389 2020-04-23T11:06:54Z 2020-04-23T11:06:54Z MEMBER

comment from @benbovy in #3625:

I re-used pandas templates for xarray accessors here: https://github.com/benbovy/xarray-simlab/blob/45359e99cbf6341464b02cb937618c051a58a31c/doc/conf.py#L233

It works pretty well: https://xarray-simlab.readthedocs.io/en/latest/api.html#dataset-xsimlab-xarray-accessor

For reference, here's pandas' version: https://github.com/pandas-dev/pandas/blob/837daf18d480cce18c25844c591c39da19437252/doc/source/conf.py#L441-L591

I think to make this a bit easier for everyone we should add this to the documentation on accessors.

Also, we could create a sphinx extension module that contains all the code in conf.py so defining the custom directives would be as simple as adding something like "xarray.doc.accessors" to extensions. The module doesn't have to be in xarray, though, it could also become a separate package.

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