This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Tony R.
Recipients Tony R., docs@python
Date 2015-10-23.17:23:09
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1445621003.26.0.876373693451.issue25467@psf.upfronthosting.co.za>
In-reply-to
Content
Python has wonderful, detailed documentation.  I love it!

Unfortunately, I have often found myself reading the otherwise-excellent documentation on a class/function/whatever, only to find out at the END of my reading that it is deprecated.

This is frustrating, and counter-intuitive.  If something is deprecated, I want to know it before I read any further.  

I have attached a patch with the relevant changes.  I hope it helps!
History
Date User Action Args
2015-10-23 17:23:25Tony R.setrecipients: + Tony R., docs@python
2015-10-23 17:23:23Tony R.setmessageid: <1445621003.26.0.876373693451.issue25467@psf.upfronthosting.co.za>
2015-10-23 17:23:23Tony R.linkissue25467 messages
2015-10-23 17:23:22Tony R.create