From b726f9edba0eaebd97211ad2b246f20de6234523 Mon Sep 17 00:00:00 2001
From: Fabio Lima <fabiolimace@gmail.com>
Date: Tue, 2 Jan 2024 18:55:03 -0300
Subject: [PATCH] Update docs

---
 CHANGELOG.md                                   |  6 ++++--
 src/main/java/com/github/f4b6a3/ulid/Ulid.java | 11 ++++++++---
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0959991..787db79 100644
--- a/CHANGELOG.md
+++ b/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
 
diff --git a/src/main/java/com/github/f4b6a3/ulid/Ulid.java b/src/main/java/com/github/f4b6a3/ulid/Ulid.java
index 40bcc5e..dd6f5d2 100644
--- a/src/main/java/com/github/f4b6a3/ulid/Ulid.java
+++ b/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() {