[DOCUMENTATION] Clarify ambiguous String Documentation

[ColinSORourke]

The documentation for the native String Class contains an ambiguity in the description of the CompareTo functions (casecmp_to(), nocasecmp_to(), naturalcasecmpto(), and naturalnocasecmp_to()

The description currently reads:

Performs a case-sensitive comparison to another string. Returns -1 if less than, 1 if greater than, or 0 if equal. "Less than" and "greater than" are determined by the Unicode code points of each string, which roughly matches the alphabetical order.

With different string lengths, returns 1 if this string is longer than the to string, or -1 if shorter. Note that the length of empty strings is always 0.

When looking at an example such as
"aab".nocasecmp_to("aaaa")
The most direct interpretation of the current wording suggests the nocasecmp_to() would return -1 because this string is shorter than the to string. The actual behavior of the function is that it returns 1 because the character comparison reaches 'b' v. 'a' and determines 'b' and the first string are greater than the second string (matching the common definition of Lexicographical Order). The length comparison only occurs conditionally, if the comparison had not yet already resolved.

I suggest updating this wording in the relevant to locations to

If the character comparison reaches the end of one string, but the other contains more characters, then it will use length as the deciding factor: 1 will be returned if this string is longer than the to string, or -1 if shorter.

Which I believe more accurately communicates the behavior of the function. Thanks!