update installation instruction

[mathause]

• Closes pynio package not found #3756
• Fully documented, including whats-new.rst for all changes and api.rst for new API

[mathause]

I thought it best to remove the instructions

$ conda install -c conda-forge xarray cartopy pynio pseudonetcdf

completely - else people are going to copy-paste the line regardless of what's written in the text. Most people won't need these specific packages.

@raybellwaves, @keewis

[keewis]

except from the link mentioned below this looks good to me

[keewis]

this link looks strange to me and I think it does not point anywhere. To fix it, I'd add a label in front of the Optional dependencies heading and then reference that:

`optional dependencies <optional-dependencies>`_

or

:doc:`optional-dependencies`

[mathause]

Thanks for the quick feedback. I found somewhere that you can directly link to titles, but this is more explicit.

[raybellwaves]

LGTM

[max-sixty]

👍

[keewis]

I didn't know that, I thought that was limited to nbsphinx. It did work, though, the link pointed to some anchor; you just specified the wrong name.

I think you can also use a mixture of both:

:ref:`optional dependencies <optional-dependencies>`

Also, using :ref: should fix the build error.

[keewis]

the docs build passed. Thanks, @mathause