From ed8aa33646e91698cdd01dc0df7a67911969ba98 Mon Sep 17 00:00:00 2001
From: Dave Smith <getdavemail@gmail.com>
Date: Wed, 7 Sep 2022 06:48:10 +0100
Subject: [PATCH] Improve comments around attribute migration effect

---
 packages/block-library/src/navigation/edit/index.js | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/block-library/src/navigation/edit/index.js b/packages/block-library/src/navigation/edit/index.js
index 7f266bf82b8dc..8ef4dc55cfbda 100644
--- a/packages/block-library/src/navigation/edit/index.js
+++ b/packages/block-library/src/navigation/edit/index.js
@@ -303,8 +303,9 @@ function Navigation( {
 	const isEntityAvailable =
 		! isNavigationMenuMissing && isNavigationMenuResolved;
 
-	// Migrate numerical ID-based ref to
-	// string slug-based ref.
+	// Migrate the numerical ID-based ref attribute to the
+	// string-based slug attribute. This action soft-deprecates
+	// usage of the ref attribute in favour of the slug attribute.
 	useEffect( () => {
 		if ( isEntityAvailable && isNumeric( ref ) ) {
 			setRef( navigationMenu?.slug );