@@ -109,16 +109,34 @@ properties:
109109methods :
110110 - name : HttpService:GenerateGUID
111111 summary : |
112- Generates a UUID /GUID random string, optionally with curly braces.
112+ Generates a /GUID random string, optionally with curly braces.
113113 description : |
114- This method randomly creates a 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
117117 (base 16) digits, displayed in 5 groups separated by hyphens in the form
118118 `8-4-4-4-12` for a total of 36 characters, for example
119119 `123e4567-e89b-12d3-a456-426655440000`. The UUID specification used is
120- [Version 4 (Random Data)](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))
121- Variant 1 (DCE 1.1, ISO/IEC 11578:1996).
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
131+ 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))
122140
123141 The `wrapInCurlyBraces` argument determines whether the returned string is
124142 wrapped in curly braces (`{}`). For instance:
0 commit comments