diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5f5cf82..feae144 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,13 +1,24 @@
 # Changelog
 
+All notable changes to CloudSaveKit are documented here.
+
+## 0.2.5 — 2026-09-14
+
+### Documentation
+
+- Added integration, explicit-synchronization, shared-zone, and troubleshooting guides to the public DocC catalog.
+- Documented required CloudKit, Push Notifications, background-mode, signing, and provisioning configuration.
+- Clarified host persistence responsibilities, checkpoint provenance, transfer-count attribution, shared-zone recovery, and two-device acceptance.
+- Updated the package installation example to the current release.
+
+This release contains no public API or runtime behavior changes.
+
 ## 0.2.4 — 2026-09-14
 
 ### Fixed
 
 - Preserve the first explicit fetch across the initial matching sign-in reconciliation of a nil-state engine while retaining lifecycle invalidation for every later account transition.
 
-All notable changes to CloudSaveKit are documented here.
-
 ## 0.2.3 — 2026-09-14
 
 ### Fixed
diff --git a/README.md b/README.md
index 3e9f26d..eac4edc 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ Add CloudSaveKit to your package dependencies:
 ```swift
 .package(
     url: "https://github.com/thatfactory/cloudsavekit.git",
-    from: "0.2.4"
+    from: "0.2.5"
 )
 ```