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/3625#issuecomment-618328518,https://api.github.com/repos/pydata/xarray/issues/3625,618328518,MDEyOklzc3VlQ29tbWVudDYxODMyODUxOA==,14808389,2020-04-23T10:43:45Z,2020-04-23T19:22:49Z,MEMBER,"thanks, @benbovy, this really is useful. While we can generate documentation pages without the templates, the name on that page doesn't match the link. I think we should add this to the docs (or make a helper module that others can import, or both) so this is a bit easier to find. Let's continue this discussion in #3361.","{""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,538092307 https://github.com/pydata/xarray/issues/3625#issuecomment-618203379,https://api.github.com/repos/pydata/xarray/issues/3625,618203379,MDEyOklzc3VlQ29tbWVudDYxODIwMzM3OQ==,4160723,2020-04-23T06:21:45Z,2020-04-23T06:21:45Z,MEMBER,"> I think pandas uses a system of autosummary templates for this. Maybe we can use something similar? 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 (Sorry I could have shared this sooner, I missed the issues here)","{""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,538092307 https://github.com/pydata/xarray/issues/3625#issuecomment-616872964,https://api.github.com/repos/pydata/xarray/issues/3625,616872964,MDEyOklzc3VlQ29tbWVudDYxNjg3Mjk2NA==,14808389,2020-04-21T00:04:10Z,2020-04-21T00:04:10Z,MEMBER,"actually, we don't even need the templates. The issue is that `property` refuses to work correctly when called using the class (so `ds.plot.scatter` works but `Dataset.plot.scatter` raises an `AttributeError`). This means that as soon as we use a custom descriptor, documenting methods like `Dataset.plot.scatter` or `Dataset.str.endswith` should just work.","{""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,538092307 https://github.com/pydata/xarray/issues/3625#issuecomment-616098910,https://api.github.com/repos/pydata/xarray/issues/3625,616098910,MDEyOklzc3VlQ29tbWVudDYxNjA5ODkxMA==,14808389,2020-04-19T10:34:52Z,2020-04-19T10:35:19Z,MEMBER,"this kind of looks like it is related to or a duplicate of #3361. I think `pandas` uses a system of [autosummary templates](https://github.com/pandas-dev/pandas/tree/master/doc/_templates/autosummary) for this. Maybe we can use something similar?","{""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,538092307