Skip to content

sum docstring's description of dtype=None behavior is muddled #623

Closed
@oleksandr-pavlyk

Description

@oleksandr-pavlyk
Contributor

The first bullet-point of https://data-apis.org/array-api/latest/API_specification/generated/array_api.sum.html describing behavior for dtype=None value stipulates an override condition (if data type of x has wide range than default data-type, use the data type of x), but the subsequence bullet-points unconditionally require output of the default data type for respecting input data type kinds, without acknowledging the exception stated in the first bullet-point.

I wish this description was made clearer. My read is points 2, 3, and 4 hold except in cases stipulated in point 1.

Activity

kgryte

kgryte commented on Apr 19, 2023

@kgryte
Contributor

@oleksandr-pavlyk Your reading is correct. Agreed that we should be clearer in that regard. Will work on a PR to which clarifies.

added this to the v2023 milestone on Jun 29, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

      Development

      Participants

      @kgryte@oleksandr-pavlyk

      Issue actions

        sum docstring's description of dtype=None behavior is muddled · Issue #623 · data-apis/array-api