Hi, It's probably been decades since I actually read the class-level API docs for java.lang.String, but today I did. In the second paragraph I found the following tidbit:
*String buffers support mutable strings.* My guess is "String buffers" here may refer to the java.lang.StringBuffer class? Some issues: a: Not super clear what a "string buffer" is meant to refer to b: If it's StringBuilder, then that's legacy and we should suggest StringBuilder instead c: I think it's confusing to say that StringBuffer/StringBuilder "support mutable strings" right after establishing that Strings in Java are constant and immutable. We could perhaps say that other APIs offer builders to compose and edit strings. We could: 0: Do nothing, nobody reads this text anyway 1: Remove the sentence, it provides marginal value as-is 2: Try to improve the sentence by linking to StringBuilder and rephrase "mutable strings" into something less misleading. Thanks, Eirik.
