API specification seems to assume all arrays are floats

[eric-wieser]

The description of __abs__ and especially __add__ seems to try to go into great detail about how floating point addition / abs works.

I'd argue this obscures the intent behind what is ultimately a container API, and it would be better to refer to the IEEE 754 spec (or perhaps add a separate page summarizing IEEE 754)

[rgommers]

That does sound like a good idea to make things easier on the reader. A separate page summarizing IEEE 754 sounds good to me, because that standard is non-free as well as painful to read.

[kgryte]

Rather than add a separate page, an alternative could be to place IEEE 754 details, or special cases in general, within a collapsible HTML section (aka, a details element).

[kgryte]

As part of #533, we'll move special cases below the fold, which should help address this issue. As such, I'll go ahead and close.