add note about deprecated methods