Deprecation docs

@hafriedlander Could you please review?