yeah, repalcing them by an link to the API doc is better (and avoids having the doc being out of sync with the code, assuming that the API doc is regenerated properly)