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, steven.daprano
Date 2016-08-31.01:29:30
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1472606971.12.0.900612809118.issue27901@psf.upfronthosting.co.za>
In-reply-to
Content
Assuming the reader knows the details of how Python works is not a great assumption when those documents are being used (by the most part) by people like me who are reasonable developers but who don't know, and for most cases don't care about the internals of Python.

The inspect library is a bit different I conceed, as the user is starting to poke under the belly of the beast as it were, but i do think it would be useful to link from Inspect to the data model docs, were the terminology is discussed in more detail.

If I had tried to port my existing code to Python3.5, and it would have failed it's test set at this point - I don't think that the inspect library docs as they are would have helped.

I know inspect is deliving into the internals - but for most people a block of code within a def block within a class definition is a method - that is what everyone refers to them - even though internally they aren't bound, and aren't 'methods' strictly speaking - I think the docs should try to bridge the gap between common (non expert) language and the correct language terminology where neccessary
History
Date User Action Args
2016-08-31 01:29:31anthony-flurysetrecipients: + anthony-flury, mark.dickinson, steven.daprano, r.david.murray, docs@python
2016-08-31 01:29:31anthony-flurysetmessageid: <1472606971.12.0.900612809118.issue27901@psf.upfronthosting.co.za>
2016-08-31 01:29:31anthony-flurylinkissue27901 messages
2016-08-31 01:29:30anthony-flurycreate