Clarify side effects of JsonObjectBuilder#build #178

Signed-off-by: Jorge Bescos Gascon <jorge.bescos.gascon@oracle.com>

api/src/main/java/jakarta/json/JsonObjectBuilder.java

diff --git a/api/src/main/java/jakarta/json/JsonObjectBuilder.java b/api/src/main/java/jakarta/json/JsonObjectBuilder.java
index 2b99b87..6ada9ab 100644
--- a/api/src/main/java/jakarta/json/JsonObjectBuilder.java
+++ b/api/src/main/java/jakarta/json/JsonObjectBuilder.java
@@ -276,6 +276,8 @@
      * on the order in which name/value pairs are added to the object using
      * this builder.
      *
+     * This method clears the builder.
+     *
      * @return JSON object that is being built
      */
     JsonObject build();