Add better doc and update Changelog

Author: patrickfav

CHANGELOG

@@ -5,6 +5,10 @@
 * add radix encoding/parsing and fix radix tests #6, #20
 * add support for Base32 RFC4648 non-hex alphabet encoding/parsing #21
 
+### Deprecations (will be removed in v1.0+)
+
+* `parseBase36()`/`encodeBase36()` - use `parseRadix(36)`/`encodeRadix(36)` instead
+
 ## v0.7.1
 
 * sign AFTER ProGuard so optimized version has correct jar signature
@@ -30,6 +34,10 @@
  * add constructor/converter from/to UUID #9
  * add `empty()` constructor, creating empty byte array
 
+### Deprecations (will be removed in v1.0+)
+
+* `toObjectArray()` renamed to `toBoxedArray()`
+
 ## v0.5.0
 
  * better resource handling for compression

src/main/java/at/favre/lib/bytes/BaseEncoding.java

@@ -27,6 +27,8 @@
 import java.util.Objects;
 
 /**
+ * Encoder which supports arbitrary alphabet and padding.
+ *
  * Derived from Google Guava's common/io/ BaseEncoding
  * <p>
  * See: https://github.com/google/guava/blob/v26.0/guava/src/com/google/common/io/BaseEncoding.java