array-api
array-api copied to clipboard
API specification seems to assume all arrays are floats
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)
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.
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).
As part of https://github.com/data-apis/array-api/issues/533, we'll move special cases below the fold, which should help address this issue. As such, I'll go ahead and close.