-
-
Notifications
You must be signed in to change notification settings - Fork 5.5k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improve docs for abs
, abs2
#45141
Improve docs for abs
, abs2
#45141
Conversation
Co-authored-by: Steven G. Johnson <stevenj@mit.edu>
@mcabbott Is this ready from your perspective? I feel the comments are adequately addressed and I would be comfortable to merge. |
@KristofferC You had some concerns above - I feel this is good to merge and overall makes the documentation more accessible. |
Sorry I missed your earlier comment. From my side this seems OK; also fine to delete the |
Co-authored-by: Michael Abbott <32575566+mcabbott@users.noreply.github.com>
CI is on a hiatus at the moment, but if we get a pass on doctest, let's merge. |
Co-authored-by: Steven G. Johnson <stevenj@mit.edu> Co-authored-by: Viral B. Shah <ViralBShah@users.noreply.github.com>
Co-authored-by: Steven G. Johnson <stevenj@mit.edu> Co-authored-by: Viral B. Shah <ViralBShah@users.noreply.github.com>
This extends the docs for `Int`, `Float64` etc, to * Note that Int is the default, mention that it can overflow * Explain what `1f0` means, and that Float64 is the default Similarly extends docs for `^`, `+`, `*` aiming to * Point out that `1.2 * 10^3` is a bad habit, warn about overflow * Give an example for what `literal_pow` is doing since the explanation is quite technical * Also point out overflow in `+`, as [suggested here](#45141 (comment)) * While there, mention that you can add vectors, and that vararg `+(1,2,3,4)` has a default binary behaviour * Similarly mention that vararg `*(1,2,3,4)` has a default order, from the left * While there, mention `1/2pi` and `v'v` as examples of `*`. --------- Co-authored-by: Lilith Orion Hafner <lilithhafner@gmail.com>
This adds some examples for
abs
,abs2
, since someone in this thread started at the beginning of the alphabet...