add note of deprecation, write tests to decide