some notes about deprecation added