Align Javadoc to User Guide

Author: scordio

src/main/java/io/github/scordio/junit/converters/Base64.java

@@ -26,6 +26,8 @@
 /**
  * {@link ConvertWith} composed annotation that decodes Base64-encoded instances of type
  * {@code byte[]} or {@link String} into {@code byte[]} instances.
+ * <p>
+ * The {@link #encoding} attribute configures the desired encoding scheme.
  */
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.PARAMETER, ElementType.FIELD })
 @Retention(RetentionPolicy.RUNTIME)

src/main/java/io/github/scordio/junit/converters/Bytes.java

@@ -26,6 +26,14 @@
 /**
  * {@link ConvertWith} composed annotation that converts {@link String} or number
  * instances into {@code byte[]} instances.
+ * <p>
+ * When converting strings, the input instance is encoded into a sequence of bytes. The
+ * {@link #charset} attribute configures the charset to use for conversion. If not
+ * specified, the JVM default charset is used.
+ * <p>
+ * When converting numbers, the input instance is converted into a sequence of bytes using
+ * its binary representation. The {@link #order} attribute configures the byte order to
+ * use for conversion.
  */
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.PARAMETER, ElementType.FIELD })
 @Retention(RetentionPolicy.RUNTIME)

src/main/java/io/github/scordio/junit/converters/Hex.java

@@ -26,6 +26,8 @@
 /**
  * {@link ConvertWith} composed annotation that decodes hexadecimal {@link String}
  * instances into {@code byte[]} instances.
+ * <p>
+ * The input strings are treated as case-insensitive and can be prefixed by {@code 0x}.
  */
 @Target({ ElementType.ANNOTATION_TYPE, ElementType.PARAMETER, ElementType.FIELD })
 @Retention(RetentionPolicy.RUNTIME)