deprecated docs should link to the up-to-date docs