From db33c5e77b60f9a0f19e9a35f1d0dd015ff1e71b Mon Sep 17 00:00:00 2001
From: "Christopher J. Markiewicz" <markiewicz@stanford.edu>
Date: Mon, 20 Oct 2025 22:11:22 -0400
Subject: [PATCH] doc: 25.1.0 release notes

---
 CHANGES.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index c35e1092..f3cfdc3f 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,3 +1,19 @@
+25.1.0 (October 21, 2025)
+=========================
+New feature release in the 25.1 series.
+
+This release introduces a new ``TemplateFlowClient`` class that provides the
+functionality previously exposed in ``templateflow.api``.
+``templateflow.api`` is now a thin wrapper around a global instance of ``TemplateFlowClient``,
+so existing code using ``templateflow.api`` should continue to work as before.
+
+These changes allow multiple independent clients to coexist in the same Python process,
+as well as defer loading of data from the filesystem until it is requested,
+significantly improving import time.
+
+* RF: Factor TemplateFlow into Cache and Client classes (#149)
+* FIX: Error on missing S3 files, do not write error data to disk (#148)
+
 25.0.4 (October 1, 2025)
 ========================
 Patch release to update templateflow skeleton.