Raymond Hettinger <raymond.hettin...@gmail.com> added the comment:

Guido, was it your intention that this show-up everywhere in the docs.  I had 
thought the primary motivation was to make it possible to write pure python 
code that exactly matched a C API.   

ISTM, there is no need to confront every single user of the docs with a 
notation that is known to be confusing.  From a teacher's point of view, 
pushing this notation everywhere in the docs changes the priority of the topic. 
 Formerly, it was an optional intermediate/advanced topic.  But if it is 
visible everywhere, it becomes an unavoidable day one topic for every single 
learner (that is if we want them to be able to read and understand the docs).

----------
nosy: +gvanrossum

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue37134>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to