I don't feel strongly about this, but I've been removing the documentation for deprecated methods (since there should be no reason to look up how it works).