Should we use URLs or refs in docstrings?
Discussion in https://github.com/pandas-dev/pandas/pull/26497. Which do we prefer when linking from a docstring to the docs? Something like

    ref:`categorical`

or

    http://pandas.pydata.org/pandas-docs/stable/user_guide/categorical.html