From 2c057d4854e907f767a126b4602856c4a5a51e7c Mon Sep 17 00:00:00 2001
From: Ruling-0 <47913168+Ruling-0@users.noreply.github.com>
Date: Mon, 12 Oct 2026 15:32:44 -0500
Subject: [PATCH] Doc pass

---
 src/main/java/forestry/core/utils/PosteaCompat.java | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/main/java/forestry/core/utils/PosteaCompat.java b/src/main/java/forestry/core/utils/PosteaCompat.java
index 690444590..0f74b4c09 100644
--- a/src/main/java/forestry/core/utils/PosteaCompat.java
+++ b/src/main/java/forestry/core/utils/PosteaCompat.java
@@ -1,14 +1,17 @@
 package forestry.core.utils;
 
+import com.gtnewhorizons.postea.api.IVersionedTransformer;
 import net.minecraft.nbt.NBTTagCompound;
 
 import com.gtnewhorizons.postea.api.CustomDataReplacementManager;
 
 import cpw.mods.fml.common.Loader;
 
-/// Offers Forestry's mail boxes to Postea's custom world data API, so versioned transformers rewrite
-/// their stacks exactly once per content version change. Safe to call without Postea installed: the Postea types
-/// live in the inner holder, which only loads when the mod is present.
+/// Used to provide custom save data (like mail boxes) to Postea's [IVersionedTransformer]s.
+///
+/// These transformers allow other mods to change saved data based on their own version stamps. This compat flags,
+/// to those transformers, the times they should fire. [#transform] is used before consuming data, so the transformer
+/// can run, and [#stamp] is used for fresh data to ensure the transformer can add a stamp of its current version.
 public final class PosteaCompat {
 
     private static final boolean POSTEA = Loader.isModLoaded("postea");