You can use a `.. seealso::` Sphinx directive here instead ... e.g. https://github.com/niallrobinson/iris/blob/6701cd4f3454733cff5d43202c6768b0933a8e3a/lib/iris/cube.py#L1025