diff --git a/S1API/Internal/Abstraction/Registerable.cs b/S1API/Internal/Abstraction/Registerable.cs
index e0b9b920..9383c441 100644
--- a/S1API/Internal/Abstraction/Registerable.cs
+++ b/S1API/Internal/Abstraction/Registerable.cs
@@ -1,9 +1,13 @@
 namespace S1API.Internal.Abstraction
 {
     /// <summary>
-    /// INTERNAL: A registerable base class for use internally.
-    /// Not intended for modder use.
+    /// Infrastructure base class for S1API registration and lifecycle hooks.
     /// </summary>
+    /// <remarks>
+    /// This class is public because public API classes inherit from it.
+    /// Modders should inherit from the appropriate API base class, such as
+    /// <c>NPC</c>, <c>Quest</c>, or <c>Saveable</c>, rather than this infrastructure class directly.
+    /// </remarks>
     public abstract class Registerable : IRegisterable
     {
         /// <summary>
diff --git a/S1API/Internal/Abstraction/Saveable.cs b/S1API/Internal/Abstraction/Saveable.cs
index f0886f69..a93ea17d 100644
--- a/S1API/Internal/Abstraction/Saveable.cs
+++ b/S1API/Internal/Abstraction/Saveable.cs
@@ -25,8 +25,15 @@
 namespace S1API.Internal.Abstraction
 {
     /// <summary>
-    /// Generic wrapper for saveable classes.
+    /// Base class for mod data persisted in the game's save slots.
     /// </summary>
+    /// <remarks>
+    /// This is a supported modder-facing API despite its <c>S1API.Internal.Abstraction</c> namespace.
+    /// Inherit from this class for standalone mod save data and mark fields with
+    /// <see cref="SaveableField"/>. Override <see cref="OnLoaded"/> and <see cref="OnSaved"/>
+    /// to respond to persistence events, and <see cref="LoadOrder"/> to control load timing.
+    /// API classes such as <c>NPC</c> and <c>Quest</c> already inherit this persistence support.
+    /// </remarks>
     public abstract class Saveable : Registerable, ISaveable
     {
         /// <summary>