Message 185120 - Python tracker (original) (raw)

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.