Added deprecated section to annotation docs (#19)

* Added deprecated section to annotation docs

* Fix syntax issue

* Fixed prettier issues in a way that also result in valid syntax

Prettier support for mdx seems to be limited

* Added upgrade instructions to deprecated annotations

* Run prettier

* Addressed Review

* Addressed review

Author: lolleko