From 0ec65bf39d203e7d9f3890998c2eb4e72726ac0e Mon Sep 17 00:00:00 2001
From: ZhouXY108 <luquanlion@outlook.com>
Date: Mon, 13 Apr 2026 22:27:13 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../xyz/zhouxy/plusone/commons/collection/MapModifier.java    | 1 -
 .../main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java   | 4 ++--
 .../java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java   | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/MapModifier.java b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/MapModifier.java
index 5cf5e97..6f8926a 100644
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/MapModifier.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/collection/MapModifier.java
@@ -215,7 +215,6 @@ public class MapModifier<K, V> {
      * 修改 {@code map}
      *
      * @param map 要修改的 {@code map}
-     * @return 修改后的 {@code map}。当入参是 {@code null} 时，返回 {@code null}。
      */
     public <T extends Map<K, V>> void modify(@Nullable T map) {
         if (map != null) {
diff --git a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java
index 66a4e95..1b3cfa7 100644
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/IdWorker.java
@@ -30,7 +30,7 @@ import xyz.zhouxy.plusone.commons.exception.system.NoAvailableMacFoundException;
  * 修改版雪花 ID 生成器
  *
  * <p>
- * 来自 Seata (https://seata.apache.org) 的 {@code org.apache.seata.common.util.IdWorker}
+ * 来自 <a href="https://seata.apache.org">Seata</a> 的 {@code org.apache.seata.common.util.IdWorker}
  *
  * <p>
  * 大体思路为：
@@ -183,7 +183,7 @@ public class IdWorker {
     /**
      * use lowest 10 bit of available MAC as workerId
      * @return workerId
-     * @throws SocketException
+     * @throws SocketException if an I/O error occurs.
      * @throws NoAvailableMacFoundException when there is no available mac found
      */
     private static long generateWorkerIdBaseOnMac() throws SocketException, NoAvailableMacFoundException {
diff --git a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java
index 49ceeee..0190833 100644
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java
@@ -197,7 +197,7 @@ public class JodaTimeTools {
      *
      * @param instant      joda-time 中的时间戳
      * @param dateTimeZone joda-time 中的时区
-     * @return
+     * @return java.time 中带时区的日期时间
      */
     public static java.time.ZonedDateTime toZonedDateTime(
             org.joda.time.Instant instant,