On Sun, 7 Jun 2026 19:14:54 GMT, Joe Darcy <[email protected]> wrote:
>> BigDecimal has a discussion section about Algorithmic Complexity of >> toPlainString. However, that is in the class-level notes and somewhat hard >> to discover; we can add a link in the "See also" section. >> >> --------- >> - [x] I confirm that I make this contribution in accordance with the >> [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai). > > src/java.base/share/classes/java/math/BigDecimal.java line 3499: > >> 3497: * (This method behaves analogously to the {@code toString} >> 3498: * method in 1.4 and earlier releases.) >> 3499: * > > If a link like this is going to be made, I think it would be fine to make it > more explicit. For example, an `@apiNote` along the lines of "A plain string > can be really big for a compact input" that contains a link to the general > section. That said, this method can benefit from `<p>` breaks and migrating "Note that" to `@apiNote` paragraphs. Should we do that? ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/31413#discussion_r3370275272
