[Docs] Give bottom-up examples in Decorators.md

[dhmlau]

Description / Steps to reproduce / Feature proposal

Based on the spike, here are the acceptance criteria:

• decorators
  • api decorator, move it to the bottom and declare that it's not fully supported yet.

[stale]

This issue has been marked stale because it has not seen activity within six months. If you believe this to be in error, please contact one of the code owners, listed in the CODEOWNERS file at the top-level of this repository. This issue will be closed within 30 days of being stale.

[stale]

This issue has been closed due to continued inactivity. Thank you for your understanding. If you believe this to be in error, please contact one of the code owners, listed in the CODEOWNERS file at the top-level of this repository.