My two cents on this:
The information to describe the deprecation is used to set the content and title in an error box at the top.
The deprecated content is indented with a border continuing the highlight from the error box on the left side, all the way down.
In edition/preview modes, the warning box is not visible. This way, it’s way less distracting, but it’s still easy to separate doc for deprecated features from the rest.
Side thought: a similar pattern could also work to display renderingerrors as an improvement for XS 
