@@ -9,10 +9,25 @@ This document follows the conventions laid out in [Keep a CHANGELOG][].
 
 ### Added
 
+- Support for Python 3.15 (#2729)
+- Support for free-threaded Python 3.14 (`Py_GIL_DISABLED`) (#2721)
+- Threading documentation covering GIL ownership, managed threads, and
+  free-threaded Python (#2721)
+
 ### Changed
 
+- Raise the minimum supported Python version from 3.10 to 3.11 (#2729)
+- Make runtime caches and CLR type binding safe for concurrent access (#2721)
+- Migrate the Visual Studio solution to the `.slnx` format (#2733)
+- Update GitHub Actions dependencies (#2739)
+
 ### Fixed
 
+- Fix races in finalization, buffer disposal, assembly path updates, and
+  Python subclass creation (#2721)
+- Fix method binding initialization when methods are first accessed (#2721)
+- Fix wheel and NuGet preview package builds
+
 ## 3.1.0 - 2026-05-23
 
 ### Added
 
@@ -23,8 +23,9 @@ speeds for Python code. If you are interested in a pure managed-code
 implementation of the Python language, you should check out the
 `IronPython`_ project.
 
-Python.NET is currently compatible and tested with Python releases from 3.7
-onwards.
+Python.NET is currently compatible and tested with Python releases 3.11
+through 3.15. Free-threaded CPython is supported starting with Python 3.14;
+see :doc:`threading` for the threading and GIL guidance.
 
 Current releases are available on `PyPi <https://pypi.org/project/pythonnet/>`_
 and `Nuget.org <https://nuget.org/packages/pythonnet>`_.
 
@@ -481,7 +481,7 @@ Python idioms:
        name = item.GetName()
 
 Using Context Managers (IDisposable)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .NET types that implement ``IDisposable`` can be used with Python's context manager
 protocol using the standard ``with`` statement. This automatically calls the object's
 
@@ -3,8 +3,10 @@ Threading
 
 This page explains how Python.NET interacts with the Python Global Interpreter
 Lock (GIL) and with managed threads, and what guarantees the runtime makes
-when your code is multi-threaded.  It covers both classic CPython builds and
-the free-threaded build introduced in CPython 3.13 (``Py_GIL_DISABLED``).
+when your code is multi-threaded. It covers classic CPython builds for Python
+3.11 through 3.15 and the free-threaded builds introduced in CPython 3.13
+(``Py_GIL_DISABLED``). Python.NET supports free-threaded CPython starting with
+Python 3.14.
 
 The model in one paragraph
 --------------------------
@@ -180,17 +182,18 @@ If you start a managed thread while holding the GIL and the thread needs to
 call back into Python, release the GIL first so the new thread can acquire
 it::
 
+    IntPtr threadState;
     using (Py.GIL())
     {
         var pyCallback = scope.Get("on_done");
-        PythonEngine.BeginAllowThreads();   // let workers acquire the GIL
+        threadState = PythonEngine.BeginAllowThreads(); // let workers acquire the GIL
         try
         {
             // spawn workers, wait for them...
         }
         finally
         {
-            PythonEngine.EndAllowThreads(...);
+            PythonEngine.EndAllowThreads(threadState);
         }
     }
 
 
@@ -20,7 +20,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: C#",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
Original file line number	Diff line number	Diff line change
@@ -3,8 +3,10 @@ Threading
3	3
4	4	This page explains how Python.NET interacts with the Python Global Interpreter
5	5	Lock (GIL) and with managed threads, and what guarantees the runtime makes
6		- when your code is multi-threaded. It covers both classic CPython builds and
7		- the free-threaded build introduced in CPython 3.13 (``Py_GIL_DISABLED``).
	6	+ when your code is multi-threaded. It covers classic CPython builds for Python
	7	+ 3.11 through 3.15 and the free-threaded builds introduced in CPython 3.13
	8	+ (``Py_GIL_DISABLED``). Python.NET supports free-threaded CPython starting with
	9	+ Python 3.14.
8	10
9	11	The model in one paragraph
10	12	--------------------------
@@ -180,17 +182,18 @@ If you start a managed thread while holding the GIL and the thread needs to
180	182	call back into Python, release the GIL first so the new thread can acquire
181	183	it::
182	184
	185	+ IntPtr threadState;
183	186	using (Py.GIL())
184	187	{
185	188	var pyCallback = scope.Get("on_done");
186		- PythonEngine.BeginAllowThreads(); // let workers acquire the GIL
	189	+ threadState = PythonEngine.BeginAllowThreads(); // let workers acquire the GIL
187	190	try
188	191	{
189	192	// spawn workers, wait for them...
190	193	}
191	194	finally
192	195	{
193		- PythonEngine.EndAllowThreads(...);
	196	+ PythonEngine.EndAllowThreads(threadState);
194	197	}
195	198	}
196	199