From 90c479995102963022ea9fb0e6423fbe5a3de211 Mon Sep 17 00:00:00 2001
From: David Hewitt <mail@davidhewitt.dev>
Date: Wed, 10 Jul 2024 15:18:13 +0100
Subject: [PATCH] docs: fixups to 0.22 migration guide (#4332)

---
 guide/src/migration.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/guide/src/migration.md b/guide/src/migration.md
index 626458b4..ab301aff 100644
--- a/guide/src/migration.md
+++ b/guide/src/migration.md
@@ -5,6 +5,15 @@ For a detailed list of all changes, see the [CHANGELOG](changelog.md).
 
 ## from 0.21.* to 0.22
 
+### Deprecation of `gil-refs` feature continues
+<details open>
+<summary><small>Click to expand</small></summary>
+
+Following the introduction of the "Bound" API in PyO3 0.21 and the planned removal of the "GIL Refs" API, all functionality related to GIL Refs is now gated behind the `gil-refs` feature and emits a deprecation warning on use.
+
+See <a href="#from-021-to-022">the 0.21 migration entry</a> for help upgrading.
+</details>
+
 ### Deprecation of implicit default for trailing optional arguments
 <details open>
 <summary><small>Click to expand</small></summary>
@@ -528,6 +537,7 @@ assert_eq!(&*name, "list");
 # }
 # Python::with_gil(example).unwrap();
 ```
+</details>
 
 ## from 0.19.* to 0.20