Fixes for deprecate.dd

* Fix a dangerous example of using `scoped`.
* Add and improve ddoc links.