diff --git a/editor/modes/visual-editor/block.js b/editor/modes/visual-editor/block.js
index 1e43e9182e0006..2101454a2f9e63 100644
--- a/editor/modes/visual-editor/block.js
+++ b/editor/modes/visual-editor/block.js
@@ -112,7 +112,7 @@ class VisualEditorBlock extends wp.element.Component {
onDeselect,
} = this.props;
- // Remove block on backspace
+ // Remove block on backspace.
if ( BACKSPACE === keyCode ) {
if ( target === this.node ) {
onRemove( [ uid ] );
@@ -127,7 +127,7 @@ class VisualEditorBlock extends wp.element.Component {
}
}
- // Deselect on escape
+ // Deselect on escape.
if ( ESCAPE === keyCode ) {
onDeselect();
}
@@ -136,7 +136,7 @@ class VisualEditorBlock extends wp.element.Component {
mergeBlocks( forward = false ) {
const { block, previousBlock, nextBlock, onMerge } = this.props;
- // Do nothing when it's the first block
+ // Do nothing when it's the first block.
if (
( ! forward && ! previousBlock ) ||
( forward && ! nextBlock )
@@ -153,7 +153,6 @@ class VisualEditorBlock extends wp.element.Component {
selectAndStopPropagation( event ) {
this.props.onSelect();
-
// Visual editor infers click as intent to clear the selected block, so
// prevent bubbling when occurring on block where selection is intended
event.stopPropagation();
@@ -168,7 +167,7 @@ class VisualEditorBlock extends wp.element.Component {
this.previousOffset = null;
}
- // Focus node when focus state is programmatically transferred
+ // Focus node when focus state is programmatically transferred.
if ( this.props.focus && ! prevProps.focus ) {
this.node.focus();
}
@@ -183,16 +182,23 @@ class VisualEditorBlock extends wp.element.Component {
render() {
const { block, selectedBlocks } = this.props;
const blockType = wp.blocks.getBlockType( block.name );
-
+ // The block as rendered in the editor is composed of general block UI
+ // (mover, toolbar, wrapper) and the display of the block content, which
+ // is referred to as