docs(UIKit): Add deprecation notes

Jeremy Elderrequested to merge
ui-kit-deprecation-proposal into main

Purpose

We need documented guidelines on how to handle deprecation in the UI kit.

Merge request reports