you should use ``@see`` to link to the other method instead, so that the API doc contains a link