Improve comments

WordPress · Nov 21, 2024 · f502d30 · f502d30
1 parent 8b92b76
commit f502d30
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 4 deletions.
diff --git a/lib/compat/wordpress-6.8/blocks.php b/lib/compat/wordpress-6.8/blocks.php
@@ -97,8 +97,9 @@ function gutenberg_stabilize_experimental_block_supports( $args ) {
 		$stable_config = is_array( $config ) ? $stabilize_config( $config, $stable_support_key ) : $config;
 
 		/*
-		 * When both experimental and stable configs are present, use the order they
-		 * are defined in to determine the final value.
+		 * If a plugin overrides the support config with the `register_block_type_args`
+		 * filter, both experimental and stable configs may be present. In that case,
+		 * use the order keys are defined in to determine the final value.
 		 *    - If config is an array, merge the arrays in their order of definition.
 		 *    - If config is not an array, use the value defined last.
 		 *

diff --git a/packages/blocks/src/store/process-block-type.js b/packages/blocks/src/store/process-block-type.js
@@ -162,8 +162,9 @@ function stabilizeSupports( rawSupports ) {
 			: config;
 
 		/*
-		 * When both experimental and stable configs are present, use the order they
-		 * are defined in to determine the final value.
+		 * If a plugin overrides the support config with the `blocks.registerBlockType`
+		 * filter, both experimental and stable configs may be present. In that case,
+		 * use the order keys are defined in to determine the final value.
 		 *    - If config is an array, merge the arrays in their order of definition.
 		 *    - If config is not an array, use the value defined last.
 		 *