updated to include deprecation notes