Yeah, that would be useful. Someone going to the docs (regardless of version perhaps) should be made aware that a method will be removed in the future