document deprecation