Author mdk
Recipients belopolsky, docs@python, georg.brandl, jyasskin, mark.dickinson, martin.panter, mdk, rhettinger
Date 2016-03-13.18:23:07
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1457893387.64.0.794753103981.issue26512@psf.upfronthosting.co.za>
In-reply-to
Content
Daily meditations:

 - This table is nice to show that there's various operations common to int and float (and does it well), not to list rounding methods (it happen to have only rounding methods, but that's a coincidence).

 - A coma separated list like ":func:`math.trunc`, :func:`round`, :func:`math.floor`, and :func:`math.ceil`." are enough to list them and to show they contain various rounding methods which is clear about the fact they are a bit different.

 - Yet we have to be both readable for everybody and ultra precise about implementation for those implementing their own __floor__, and the math module does it really nicely.

But we can keep the table without the empty "Notes" column, leaving place to explain them with more words, so they  can be more readable, approaching this way the readability of the math module ?

Finally, the problem is the conciseness of the result column (which make me think a link is better than a too-concise explanation).
History
Date User Action Args
2016-03-13 18:23:07mdksetrecipients: + mdk, georg.brandl, rhettinger, mark.dickinson, belopolsky, jyasskin, docs@python, martin.panter
2016-03-13 18:23:07mdksetmessageid: <1457893387.64.0.794753103981.issue26512@psf.upfronthosting.co.za>
2016-03-13 18:23:07mdklinkissue26512 messages
2016-03-13 18:23:07mdkcreate