diff --git a/packages/block-library/src/image/edit.js b/packages/block-library/src/image/edit.js
index 51d2587591eda3..c6336b03508364 100644
--- a/packages/block-library/src/image/edit.js
+++ b/packages/block-library/src/image/edit.js
@@ -28,6 +28,7 @@ import {
ToggleControl,
Toolbar,
withNotices,
+ ExternalLink,
} from '@wordpress/components';
import { compose } from '@wordpress/compose';
import { withSelect } from '@wordpress/data';
@@ -456,7 +457,14 @@ class ImageEdit extends Component {
label={ __( 'Alt Text (Alternative Text)' ) }
value={ alt }
onChange={ this.updateAlt }
- help={ __( 'Alternative text describes your image to people who can’t see it. Add a short description with its key details.' ) }
+ help={
+
+
+ { __( 'Describe the purpose of the image' ) }
+
+ { __( 'Leave empty if the image is purely decorative.' ) }
+
+ }
/>
{ ! isEmpty( imageSizeOptions ) && (
+
+ { __( 'Describe the purpose of the image' ) }
+
+ { __( 'Leave empty if the image is purely decorative.' ) }
+
+ }
/> ) }
);
diff --git a/packages/components/src/base-control/README.md b/packages/components/src/base-control/README.md
index 4a0dd8712ee3f3..f451a75b6ee4fd 100644
--- a/packages/components/src/base-control/README.md
+++ b/packages/components/src/base-control/README.md
@@ -45,7 +45,7 @@ If this property is added, a label will be generated using label property as the
If this property is added, a help text will be generated using help property as the content.
-- Type: `String`
+- Type: `String|WPElement`
- Required: No
### className
diff --git a/packages/components/src/checkbox-control/README.md b/packages/components/src/checkbox-control/README.md
index 91b50a09b2d970..c011fd2c56fe1f 100644
--- a/packages/components/src/checkbox-control/README.md
+++ b/packages/components/src/checkbox-control/README.md
@@ -60,7 +60,7 @@ import { withState } from '@wordpress/compose';
const MyCheckboxControl = withState( {
isChecked: true,
-} )( ( { isChecked, setState } ) => (
+} )( ( { isChecked, setState } ) => (
(
+} )( ( { option, setState } ) => (
(
+} )( ( { columns, setState } ) => (
(
+ } )( ( { size, setState } ) => (
(
+} )( ( { className, setState } ) => (
(
+ } )( ( { text, setState } ) => (
(
+} )( ( { hasFixedBackground, setState } ) => (
setState( ( state ) => ( { hasFixedBackground: ! state.hasFixedBackground } ) ) }
/>
@@ -37,7 +37,7 @@ If this property is added, a label will be generated using label property as the
If this property is added, a help text will be generated using help property as the content.
-- Type: `String` | `Function`
+- Type: `String|WPElement`
- Required: No
### checked
@@ -61,4 +61,3 @@ The class that will be added with `components-base-control` and `components-togg
Type: String
Required: No
-