Issue #119 Clarify BigDecimal text-policy examples

Co-authored-by: simbo1905 <simbo1905@60hertz.com>

Author: cursoragent

json-java21/src/test/java/jdk/sandbox/java/util/json/DesignChoicesNumberExamplesTest.java

@@ -49,12 +49,15 @@ void parseExponentFormToBigIntegerExactWorks() {
     void bigDecimalToJsonNumberRequiresChoosingATextPolicy() {
         LOGGER.info("Executing bigDecimalToJsonNumberRequiresChoosingATextPolicy");
 
-        var thousand = new BigDecimal("1000");
+        // Using toPlainString() for a plain number representation
+        var bdPlain = new BigDecimal("1000");
 
-        var plain = JsonNumber.of(thousand.toPlainString());
+        var plain = JsonNumber.of(bdPlain.toPlainString());
         assertThat(plain.toString()).isEqualTo("1000");
 
-        var scientific = JsonNumber.of(new BigDecimal("1E+3").toString());
+        // Using toString(), which may produce scientific notation
+        var bdScientific = new BigDecimal("1E+3");
+        var scientific = JsonNumber.of(bdScientific.toString());
         assertThat(scientific.toString()).isEqualTo("1E+3");
     }
 

json-java21/src/test/java/jdk/sandbox/java/util/json/examples/DesignChoicesExamples.java

@@ -40,12 +40,15 @@ public static BigInteger parseToBigIntegerExact() {
     }
 
     public static JsonNumber bigDecimalToJsonNumberChooseTextPolicy() {
-        var bd = new BigDecimal("1000");
+        // Example with toPlainString() to avoid scientific notation.
+        var bdPlain = new BigDecimal("1000");
 
-        var plain = JsonNumber.of(bd.toPlainString());
+        var plain = JsonNumber.of(bdPlain.toPlainString());
         System.out.println("BigDecimal.toPlainString() -> JsonNumber: " + plain);
 
-        var scientific = JsonNumber.of(new BigDecimal("1E+3").toString());
+        // Example with toString(), which may use scientific notation.
+        var bdScientific = new BigDecimal("1E+3");
+        var scientific = JsonNumber.of(bdScientific.toString());
         System.out.println("BigDecimal.toString()      -> JsonNumber: " + scientific);
 
         return plain;