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 1620573171,I_kwDOAMm_X85gl_vz,7617,The documentation contains some non-descriptive link texts.,51911758,closed,0,,,4,2023-03-13T00:34:09Z,2023-03-27T21:37:21Z,2023-03-27T21:37:20Z,CONTRIBUTOR,,,,"### What is your issue? I've been going through the docs and noticed some links could be more descriptive. Here are a few examples with options on how we could rewrite them: - See the [user guide](https://docs.xarray.dev/en/stable/indexing.html) for more. -> Check out the [indexing section in the user guide](https://docs.xarray.dev/en/stable/indexing.html) for a detailed explanation. - For more, see [the Xarray documentation](https://docs.xarray.dev/en/stable/user-guide/computation.html#automatic-alignment). -> See the [documentation on automatic alignment](https://docs.xarray.dev/en/stable/user-guide/computation.html#automatic-alignment) to learn more. - [This tutorial notebook](https://tutorial.xarray.dev/fundamentals/02.3_aligning_data_objects.html) also covers alignment and broadcasting (highly recommended)-> You can also check out this [tutorial notebook on alignment and broadcasting](https://tutorial.xarray.dev/fundamentals/02.3_aligning_data_objects.html) (highly recommended). - For more see the [user guide](https://docs.xarray.dev/en/stable/plotting.html), the [gallery](https://docs.xarray.dev/en/stable/examples/visualization_gallery.html), and [the tutorial material](https://tutorial.xarray.dev/fundamentals/04.0_plotting.html). -> For more information, check out the following resources: * The [plotting documentation](https://docs.xarray.dev/en/stable/user-guide/plotting.html) in the user guide. * The [visualization gallery](https://docs.xarray.dev/en/stable/examples/visualization_gallery.html). * The [plotting and visualization tutorial materials](https://tutorial.xarray.dev/fundamentals/04.0_plotting.html). With more specific link texts, you get a clearer idea of what to expect when you click on the link which improves the reading experience. It also makes the links more accessible.","{""url"": ""https://api.github.com/repos/pydata/xarray/issues/7617/reactions"", ""total_count"": 1, ""+1"": 1, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,completed,13221727,issue