added doc comment and changed description

Author: [email protected]

src/plugins/theme-block-style-inheritance/index.php

@@ -310,13 +310,24 @@ function add_body_class_block_style_inheritance( $classes ) {
 		/**
 		 * Some themes uses color-mix in their theme.json file.
 		 * This allows us to inherit the styles that uses color-mix.
+		 *
+		 * Below is the identical test performed in wp-includes/kses.php:2659
+		 * @see wp-includes/kses.php
 		 */
 		function allow_css( $allow_css, $css_test_string ) {
+			/**
+			 * Allow CSS functions like color-mix(). by removing them from the test string.
+			 * Nested functions and parentheses are also removed, so long as the parentheses are balanced.
+			 */
 			$css_test_string = preg_replace(
 				'/\b(?:color-mix)(\((?:[^()]|(?1))*\))/',
 				'',
 				$css_test_string
 			);
+			/*
+			 * Disallow CSS containing \ ( & } = or comments, except for within url(), var(), calc(), etc.
+			 * which were removed from the test string above.
+			 */
 			$allow_css = ! preg_match( '%[\\\(&=}]|/\*%', $css_test_string );
 			return $allow_css;
 		}

src/welcome/admin.js

@@ -1422,7 +1422,7 @@ const AdditionalOptions = props => {
 							<CheckboxControl
 								label={ __( 'Inherit Block Styles from theme.json', i18n ) }
 								className={ searchClassname( __( 'Inherit Block Styles from theme.json', i18n ), miscellaneous ) }
-								help={ __( `When enabled, Stackable blocks will inherit styles from the theme.json file.`, i18n ) }
+								help={ __( `When enabled, Stackable blocks will inherit styles from the theme.json file of your Block Theme.`, i18n ) }
 								checked={ ! settings.stackable_disable_block_style_inheritance }
 								onChange={ checked => {
 									handleSettingsChange( { stackable_disable_block_style_inheritance: ! checked } ) // eslint-disable-line camelcase