When Obsoleting a method, add the reason why as an engineering note above the method (see Documenting Code).