Author martin.panter
Recipients belopolsky, docs@python, georg.brandl, jyasskin, mark.dickinson, martin.panter, mdk, rhettinger
Date 2016-03-13.08:58:30
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1457859511.12.0.638923782831.issue26512@psf.upfronthosting.co.za>
In-reply-to
Content
Julien: I tend to keep doc strings rather concise. Just mention the main points, not all the obscure corner cases or examples. In this case I would probably just change “int” to “integer” (lowercase) or “numbers.Integral” if you want to be specific. You might also want to change “integral value” → “integer”.

Raymond: If you want to keep the table, please also fix the “integral float” references in Python 3 as well. Also see footnote (3) for the previous table, which also covers rounding.

I would still suggest to remove the empty “Notes” column. If there are any details worthy of footnotes, they should be added to the main documentation, not this table.
History
Date User Action Args
2016-03-13 08:58:31martin.pantersetrecipients: + martin.panter, georg.brandl, rhettinger, mark.dickinson, belopolsky, jyasskin, docs@python, mdk
2016-03-13 08:58:31martin.pantersetmessageid: <1457859511.12.0.638923782831.issue26512@psf.upfronthosting.co.za>
2016-03-13 08:58:31martin.panterlinkissue26512 messages
2016-03-13 08:58:30martin.pantercreate