some clarification on how to replace usage of deprecated methods