From 58fee8ffbce8330c1f82a047734887d954741f8c Mon Sep 17 00:00:00 2001
From: Aaron Robertshaw <60436221+aaronrobertshaw@users.noreply.github.com>
Date: Mon, 13 Dec 2021 10:08:39 +1000
Subject: [PATCH] Improve comment clarity

---
 .../inspector-controls/block-support-tools-panel.js         | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/block-editor/src/components/inspector-controls/block-support-tools-panel.js b/packages/block-editor/src/components/inspector-controls/block-support-tools-panel.js
index 05097f4c24827..086817b6713b8 100644
--- a/packages/block-editor/src/components/inspector-controls/block-support-tools-panel.js
+++ b/packages/block-editor/src/components/inspector-controls/block-support-tools-panel.js
@@ -19,8 +19,10 @@ export default function BlockSupportToolsPanel( { children, group, label } ) {
 			hasMultiSelection,
 		} = select( blockEditorStore );
 
-		// This is `null` if multi-selection and used in `clientId` checks
-		// to still allow panel items to register themselves.
+		// When we currently have a multi-selection, the value returned from
+		// `getSelectedBlockClientId()` is `null`. When a `null` value is used
+		// for the `panelId`, a `ToolsPanel` will still allow panel items to
+		// register themselves despite their panelIds not matching.
 		const selectedBlockClientId = getSelectedBlockClientId();
 
 		if ( hasMultiSelection() ) {