-
-
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
Complete uuids #28649
Complete uuids #28649
Conversation
base/uuid.jl
Outdated
""" | ||
Represents a Universally Unique Identifier (UUID). | ||
Can be built from a UInt128 (all byte values), from two UInt64 or four UInt32. | ||
Conversion from a string is will check the UUID validity. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Typo: "is will"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thanks!
base/uuid.jl
Outdated
@@ -1,5 +1,10 @@ | |||
# This file is a part of Julia. License is MIT: https://julialang.org/license | |||
|
|||
""" | |||
Represents a Universally Unique Identifier (UUID). | |||
Can be built from a UInt128 (all byte values), from two UInt64 or four UInt32. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd suggest wrapping the types in backticks, and perhaps tweaking the phrasing to be more consistent when listing the three options -- e.g. "...from one UInt128
(all byte values), from two UInt64
, or from four UInt32
." (or only use "from" once). Note also the "a" --> "one", and the added comma after UInt64
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I just re-read it, agreed on all points
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
* documented UUID type * fixed typo * improved sentence structure from doc (cherry picked from commit c62555b)
Add documentation to the UUID constructor in Base.
Also rewrote
uuid = uuid.value
tobytes = uuid.value
in the UUID package, it can be confusing to have the UUID struct with the same name as the internal bytes stored asUInt128
.