It does work in html.  It does not work in raw .rst I think.  Also it's the first recommended method when I googled how to link to another doc/section.  Lastly it's used in for instance https://github.com/ray-project/ray/blob/master/doc/source/tune.rst as well.