I think the documentation link is fine.  Verbose deprecation warnings are just going to bounce off people.