add notes on deprecation