Update docs

CHANGELOG.md

@@ -4,9 +4,11 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
-## [5.2.3] - 2023-12-17
+## [5.2.3] - 2024-01-02
 
-Remove factory methods that accept an optinal `Clock`.
+- Fix `ArrayIndexOutOfBoundsException` on input with multiple bytes for a character. #32
+- Replace `synchronized` keyword with `ReentrantLock`.
+- Remove factory methods that accept an optional `Clock` (for tests).
 
 ## [5.2.2] - 2023-09-03
 

src/main/java/com/github/f4b6a3/ulid/Ulid.java

@@ -52,8 +52,14 @@ public final class Ulid implements Serializable, Comparable<Ulid> {
 
 	private static final long serialVersionUID = 2625269413446854731L;
 
-	private final long msb; // most significant bits
-	private final long lsb; // least significant bits
+	/**
+	 * The most significant bits
+	 */
+	private final long msb;
+	/**
+	 * The least significant bits
+	 */
+	private final long lsb;
 
 	/**
 	 * Number of characters of a ULID.
@@ -209,7 +215,6 @@ public final class Ulid implements Serializable, Comparable<Ulid> {
 	 * pseudo-random generator should use {@link UlidCreator#getUlid()}.
 	 * 
 	 * @return a ULID
-	 * @see {@link ThreadLocalRandom}
 	 * @since 5.1.0
 	 */
 	public static Ulid fast() {