@@ -111,32 +111,25 @@ methods:
111111 summary : |
112112 Generates a UUID/GUID random string, optionally with curly braces.
113113 description : |
114- This method generates a **random universally unique identifier
115- ([UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier))**
114+ This method generates a **random universally unique identifier**
115+ ([UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier))
116116 string. The sixteen octets of a UUID are represented as 32 hexadecimal
117- (base 16) digits, displayed in 5 groups separated by hyphens in the form
118- `8-4-4-4-12` for a total of 36 characters, for example
119- `123e4567-e89b-12d3-a456-426655440000`. The UUID specification used is
120- Version 4 (Random Data), Variant 1 (DCE 1.1, ISO/IEC 11578:1996).
121- (See
122- [UUIDTools](https://www.uuidtools.com/uuid-versions-explained#version-4)
123- or
124- [Wikipedia](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))
125- for more info.)
126-
127- Version 4 UUIDs are the most commonly used due to their simplicity, as
128- they are entirely randomly generated.
129- This version does not have certain features that other UUID
130- versions have, such as encoded timestamps, MAC addresses, or provide
117+ (base 16) digits, displayed in five groups separated by hyphens in
118+ the form `8-4-4-4-12` for a total of 36 characters, for example
119+ `123e4567-e89b-12d3-a456-426655440000`.
120+
121+ The UUID specification used is [Version 4
122+ (random)](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)),
123+ variant 1 (DCE 1.1, ISO/IEC 11578:1996). UUIDs of this version are the
124+ most commonly used due to their simplicity, as they are entirely randomly
125+ generated. Note that this version does not have certain features that
126+ other UUID versions have, such as encoded timestamps, MAC addresses, or
131127 time-based sorting like [UUIDv7](https://uuid7.com/) or
132- [ULID](https://github.com/ulid/spec)).
133-
134- There are over 5.3 x 10<sup>36</sup> unique v4 UUIDs. The
135- probability to find a duplicate within 103 trillion version-4 UUIDs is one
136- in a billion. The number of random version-4 UUIDs which need to be
137- generated in order to have a 50% probability of at least one collision is
138- 2.71 quintillion.
139- ([Source: Wikipedia](https://en.wikipedia.org/wiki/Universally_unique_identifier#Collisions))
128+ [ULID](https://github.com/ulid/spec).
129+
130+ There are over 5.3×10<sup>36</sup> unique v4 UUIDs, in which the
131+ probability of finding a duplicate within 103 trillion UUIDs is one in a
132+ billion.
140133
141134 The `wrapInCurlyBraces` argument determines whether the returned string is
142135 wrapped in curly braces (`{}`). For instance:
0 commit comments