-
-
Notifications
You must be signed in to change notification settings - Fork 1k
Description
Checklist
Please ensure the following tasks are completed before filing an issue.
- Read and understood the Code of Conduct.
- Searched for existing issues and pull requests.
- If this is a general question, searched the FAQ for an existing answer.
- If this is a feature request, the issue name begins with
RFC:.
Description
Description of the issue (or feature request).
Along lines similar to @stdlib/math/constants/float64-half-pi, this RFC proposes the addition of a new constant package to @stdlib/math/constants; namely, pi/4. The constant pi/4 finds common occurrence in various math implementations; e.g., acos, asin, atan.
Package name possibilities include:
@stdlib/math/constants/float64-pi-over-four
@stdlib/math/constants/float64-quarter-pi
@stdlib/math/constants/float64-pi-div-four
@stdlib/math/constants/float64-pio4
@stdlib/math/constants/float64-fourth-pi
The last name possibility is consistent with float64-half-pi, but is a bit more awkward/less commonly said. Individuals may be more likely to say "pi over four" than "fourth pi". But then again, individuals may be more likely to say "pi over two" rather than "half pi". In terms of conventions, a separate convention for similar type constants could be imposed where the divisor is greater than 2; i.e., keep *-half-pi type names, but then also have *-pi-over-three, *-pi-over-four, etc.
FWIW, Boost follows the convention *-fourth-pi.
Related Issues
Does this issue (or feature request) have any related issues?
Acceptance of this proposal would impact PR #75.
Questions
Any questions for reviewers?
- According to what naming convention should the proposed package follow?