[docs] [issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"
report at bugs.python.org
Wed Oct 19 22:49:01 CEST 2011
Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:
Sorry, I'm going to reject this one. I applied the patch and looked at the generated docs, finding them to be less readable than before. AFAICT, we've had no issues with people mis-reading the text as currently presented. Also, I looked back at the underlying spec, http://speleotrove.com/decimal/daops.html , and found that it tended to refer to first and second operand. I would like to keep our docs as close to that as possible.
resolution: -> rejected
status: open -> closed
Python tracker <report at bugs.python.org>
More information about the docs