Message 185120 - Python tracker
> We do not document removals after they are done as they are not an > issue for back-compatibility (unlike changes and additions). I learned that people may use the (for example) 2.7 docs even though they are using 2.6, so I think we do want to use things like the deprecated-removed directive to tell these users that they should start looking for a replacement. Removing documentation would lead them to look in other places and discover the removals later.