id,node_id,number,title,user,state,locked,assignee,milestone,comments,created_at,updated_at,closed_at,author_association,active_lock_reason,draft,pull_request,body,reactions,performed_via_github_app,state_reason,repo,type 2070189273,I_kwDOAMm_X857ZJTZ,8596,Updated `See also` section in the docstrings broke numpydoc,35924738,open,0,,,0,2024-01-08T10:47:36Z,2024-01-09T19:24:39Z,,CONTRIBUTOR,,,,"### What happened? Hi, I would like to report that https://github.com/pydata/xarray/pull/8311 broke the [documentation build of Datashader](https://github.com/holoviz/datashader/actions/runs/7439307614/job/20239052701). Datashader's documentation uses Sphinx and `numpydoc` to process its docstrings. It turns out (I had no idea) that `numpydoc` processes more doctrings than I'd have expected, including xarray's ones. The changes in the PR made `numpydoc` unhappy. To reproduce run: ``` python3 -m venv .venv source .venv/bin/activate pip install numpydoc python -m numpydoc.hooks.validate_docstrings xarray/core/dataarray.py ``` You'll get this error: ValueError: Error parsing See Also entry ':doc:`xarray-tutorial:intermediate/indexing/indexing`' I'm pretty sure this is not an xarray issue but felt that opening an issue here might be useful for others encountering this issue. Really, feel free to close it. ### What did you expect to happen? _No response_ ### Minimal Complete Verifiable Example _No response_ ### MVCE confirmation - [ ] Minimal example — the example is as focused as reasonably possible to demonstrate the underlying issue in xarray. - [ ] Complete example — the example is self-contained, including all data and the text of any traceback. - [ ] Verifiable example — the example copy & pastes into an IPython prompt or [Binder notebook](https://mybinder.org/v2/gh/pydata/xarray/main?urlpath=lab/tree/doc/examples/blank_template.ipynb), returning the result. - [ ] New issue — a search of GitHub Issues suggests this is not a duplicate. - [ ] Recent environment — the issue occurs with the latest version of xarray and its dependencies. ### Relevant log output _No response_ ### Anything else we need to know? _No response_ ### Environment
","{""url"": ""https://api.github.com/repos/pydata/xarray/issues/8596/reactions"", ""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,,13221727,issue 995207963,MDU6SXNzdWU5OTUyMDc5NjM=,5791,Histogram's plot title could include the scalar coords values instead of being set to `Histogram`,35924738,closed,0,,,0,2021-09-13T18:42:38Z,2021-09-29T16:03:26Z,2021-09-29T16:03:26Z,CONTRIBUTOR,,,,"The plots created by xarray.plot() often include an informative title that lists the scalar coords and their values. The histogram plot doesn't have that feature, it gets a title called `Histogram`. It would be nice to have this plot to also benefit from an informative title.","{""url"": ""https://api.github.com/repos/pydata/xarray/issues/5791/reactions"", ""total_count"": 2, ""+1"": 2, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,completed,13221727,issue 995189423,MDU6SXNzdWU5OTUxODk0MjM=,5788,Numeric numbers not properly formatted in the title's plot,35924738,closed,0,,,0,2021-09-13T18:18:59Z,2021-09-23T18:28:50Z,2021-09-23T18:28:50Z,CONTRIBUTOR,,,,"See one of the figures generated in the ROMS tutorial where *Cs_r* is displayed in a very long format. Observed in the work done in here: https://github.com/holoviz/hvplot/pull/659","{""url"": ""https://api.github.com/repos/pydata/xarray/issues/5788/reactions"", ""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,completed,13221727,issue