From 6f374656a46be9919c067816bfaa7c9c1695db76 Mon Sep 17 00:00:00 2001
From: Staci Cooper <staci@Stacis-MacBook-Pro.local>
Date: Wed, 21 Oct 2020 10:44:33 -0700
Subject: [PATCH] Update docstrings to reflect refactor into dimensions feature

Some docstrings still referred to the block support as just width
support, and needed to be updated after refactoring into a larger
dimensions feature.
---
 lib/block-supports/dimensions.php             |  6 ++--
 .../src/components/width-control/index.js     | 34 +++++++++++--------
 packages/block-editor/src/hooks/dimensions.js |  4 +--
 packages/block-editor/src/hooks/style.js      |  2 +-
 4 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/lib/block-supports/dimensions.php b/lib/block-supports/dimensions.php
index 20482368de786e..801c8f21f7203e 100644
--- a/lib/block-supports/dimensions.php
+++ b/lib/block-supports/dimensions.php
@@ -1,13 +1,13 @@
 <?php
 /**
- * Width block support flag.
+ * Dimensions block support flag.
  *
  * @package gutenberg
  */
 
 /**
- * Registers the style and width block attributes for block types that
- * support it.
+ * Ensures the style attribute required by the dimensions feature is registered,
+ * for block types that support the feature.
  *
  * @param WP_Block_Type $block_type Block Type.
  */
diff --git a/packages/block-editor/src/components/width-control/index.js b/packages/block-editor/src/components/width-control/index.js
index 5fbb587899bde7..f98e9951054c0e 100644
--- a/packages/block-editor/src/components/width-control/index.js
+++ b/packages/block-editor/src/components/width-control/index.js
@@ -2,12 +2,13 @@
  * WordPress dependencies
  */
 import { Button, ButtonGroup } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
 
 /**
  * Control to facilitate width selections.
  *
  * @param  {Object}   props                 Component props.
- * @param  {string}   props.value           Currently selected text decoration.
+ * @param  {string}   props.value           Currently selected width.
  * @param  {Array}    props.widthOptions    Width options available for selection.
  * @param  {Function} props.onChange        Handles change in width selection.
  * @return {WPElement}                      Width control.
@@ -40,19 +41,22 @@ export default function WidthControl( {
 	};
 
 	return (
-		<ButtonGroup>
-			{ widthOptions.map( ( widthOption ) => {
-				return (
-					<Button
-						key={ widthOption.slug }
-						isSmall
-						isPrimary={ selectedWidth === widthOption.slug }
-						onClick={ () => handleChange( widthOption.slug ) }
-					>
-						{ widthOption.value }
-					</Button>
-				);
-			} ) }
-		</ButtonGroup>
+		<>
+			<p>{ __( 'Width' ) }</p>
+			<ButtonGroup>
+				{ widthOptions.map( ( widthOption ) => {
+					return (
+						<Button
+							key={ widthOption.slug }
+							isSmall
+							isPrimary={ selectedWidth === widthOption.slug }
+							onClick={ () => handleChange( widthOption.slug ) }
+						>
+							{ widthOption.value }
+						</Button>
+					);
+				} ) }
+			</ButtonGroup>
+		</>
 	);
 }
diff --git a/packages/block-editor/src/hooks/dimensions.js b/packages/block-editor/src/hooks/dimensions.js
index 06ca8dbcdfa61f..34dc43a68fca35 100644
--- a/packages/block-editor/src/hooks/dimensions.js
+++ b/packages/block-editor/src/hooks/dimensions.js
@@ -15,7 +15,7 @@ import WidthControl from '../components/width-control';
 
 /**
  * Key within block settings' supports array indicating support for
- * width, e.g. settings found in 'block.json'.
+ * dimensions including width, e.g. settings found in 'block.json'.
  */
 export const DIMENSIONS_SUPPORT_KEY = '__experimentalDimensions';
 
@@ -51,7 +51,7 @@ export function DimensionsPanel( props ) {
 
 	return (
 		<InspectorControls>
-			<PanelBody title={ __( 'Width Settings' ) }>
+			<PanelBody title={ __( 'Dimensions' ) }>
 				<WidthControl
 					value={ selectedWidth }
 					widthOptions={ widthOptions }
diff --git a/packages/block-editor/src/hooks/style.js b/packages/block-editor/src/hooks/style.js
index a91be3f94ccf24..7f3bb76e3825cc 100644
--- a/packages/block-editor/src/hooks/style.js
+++ b/packages/block-editor/src/hooks/style.js
@@ -158,7 +158,7 @@ export const withBlockControls = createHigherOrderComponent(
 		return [
 			<TypographyPanel key="typography" { ...props } />,
 			<ColorEdit key="colors" { ...props } />,
-			<DimensionsPanel key="width" { ...props } />,
+			<DimensionsPanel key="dimensions" { ...props } />,
 			<BlockEdit key="edit" { ...props } />,
 			hasSpacingSupport && (
 				<SpacingPanelControl key="spacing">