Fully ignored fields and methods can have shorter documentation, since knowledge of what they did does not help users of the current library version. Longer comments can also mislead some readers into believing these fields/methods are still useful to consider: for example, reading the first few sentences and thinking "this is exactly what I need," without reading far enough to see the Deprecated note at the bottom.
Deprecated-yet-usable fields/methods were not changed.
Fully ignored fields and methods can have shorter documentation, since knowledge of what they did does not help users of the current library version. Longer comments can also mislead some readers into believing these fields/methods are still useful to consider: for example, reading the first few sentences and thinking "this is exactly what I need," without reading far enough to see the Deprecated note at the bottom.
Deprecated-yet-usable fields/methods were not changed.