These are very valuable additions to the api-doc and I hope someone has the time and courage to put them into being. I specifically like the implication of seeing best practises at a glance due to the times a certain function has been used.
Though I guess, we'd see how many deprecated functions are still in use :)....
