Message 273967 - Python tracker

➜

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	anthony-flury
Recipients	anthony-flury, docs@python, mark.dickinson, r.david.murray
Date	2016-08-30.21:08:00
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1472591280.18.0.88755748748.issue27901@psf.upfronthosting.co.za>
In-reply-to

Content
Not sure I agree with closing this. I am not convinced (as a reasonably seasoned developer) that the documentation is clear. It may not be a bug in the code, resulting as it does from a change in the way methods are implemented in Python 3.5, but I do think that the documentation could be a lot clearer. It does read as if it is written for someone who already knows what the library does, rather than as a guide for someone trying to work through it for the first time. I have changed this to a documentation issue - I hope that this is ok.

Not sure I agree with closing this. I am not convinced (as a reasonably seasoned developer) that the documentation is clear.

It may not be a bug in the code, resulting as it does from a change in the way methods are implemented in Python 3.5, but I do think that the documentation could be a lot clearer. It does read as if it is written for someone who already knows what the library does, rather than as a guide for someone trying to work through it for the first time.

I have changed this to a documentation issue - I hope that this is ok.

History
Date	User	Action	Args
2016-08-30 21:08:00	anthony-flury	set	recipients: + anthony-flury, mark.dickinson, r.david.murray, docs@python
2016-08-30 21:08:00	anthony-flury	set	messageid: <1472591280.18.0.88755748748.issue27901@psf.upfronthosting.co.za>
2016-08-30 21:08:00	anthony-flury	link	issue27901 messages
2016-08-30 21:08:00	anthony-flury	create