Add documentation for `#[diagnostic::do_not_recommend]`#1663

ehuss merged 8 commits intorust-lang:masterrust-lang/reference:masterfrom

weiznich:do_not_recommendweiznich/reference:do_not_recommendCopy head branch name to clipboard