Add documentation on deprecation notices
Merge branch '1887-deprecation-notices' into gh-pages