[DOC] Improve API documentation for @ember/debug deprecate

[geneukum]

Here is an initial attempt at improving the API documentation for the deprecate function. This addresses issue #20102.

Please let me know if there are any changes that could be made to improve this further and I'll try go get those incorporated ASAP.