Resolve "Document deprecation helper template patterns"

Add the deprecations behaviors to the architecture/decisions, as well as to the developer documentation.

Closes #626 (closed)

cc @marin @joshlambert