Improve javadoc for Jsonb adapter() methods

Author: rbygrave

jsonb/src/main/java/io/avaje/jsonb/Jsonb.java

@@ -131,16 +131,6 @@ static Builder newBuilder() {
    */
   <T> JsonType<T> typeOf(Object value);
 
-  /**
-   * Return the JsonAdapter used to read and write json for the given class.
-   */
-  <T> JsonAdapter<T> adapter(Class<T> cls);
-
-  /**
-   * Return the JsonAdapter used to read and write json for the given type.
-   */
-  <T> JsonAdapter<T> adapter(Type type);
-
   /**
    * Return the JsonReader used to read the given json content.
    */
@@ -179,6 +169,22 @@ static Builder newBuilder() {
    */
   PropertyNames properties(String... names);
 
+  /**
+   * Return the JsonAdapter used to read and write json for the given class.
+   * <p>
+   * JsonAdapter is generally used by generated code and your application code
+   * is expected to use {@link Jsonb#type(Class)} and {@link JsonType} instead.
+   */
+  <T> JsonAdapter<T> adapter(Class<T> cls);
+
+  /**
+   * Return the JsonAdapter used to read and write json for the given type.
+   * <p>
+   * JsonAdapter is generally used by generated code and your application code
+   * is expected to use {@link Jsonb#type(Type)} and {@link JsonType} instead.
+   */
+  <T> JsonAdapter<T> adapter(Type type);
+
   /**
    * Build the Jsonb instance adding JsonAdapter, Factory or AdapterBuilder.
    */