Show deprecated text more prominently
Currently a deprecated widget page in GTK docs shows a pill at the top to inform that it's deprecated, but it doesn't show the text that informs the reason of the deprecation and what the users should use instead. That text is instead shown at the end of the description section, which sometimes is far away at the bottom, like in this case, so this may be totally missed. I suggest moving that text at the top, just below the "deprecated" pill. Another solution would be to make the pill clickable and make the page scroll at the deprecation text on click. Personally I prefer the former since the text is usually short.