document recent API-deprecations in README