More block description updates

packages/block-library/src/cover/index.js

@@ -83,7 +83,7 @@ const VIDEO_BACKGROUND_TYPE = 'video';
 export const settings = {
 	title: __( 'Cover' ),
 
-	description: __( 'Add a full-width image or video, and layer text over it — great for headers.' ),
+	description: __( 'Add an image or video with a text overlay — great for headers.' ),
 
 	icon: <SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><Path d="M4 4h7V2H4c-1.1 0-2 .9-2 2v7h2V4zm6 9l-4 5h12l-3-4-2.03 2.71L10 13zm7-4.5c0-.83-.67-1.5-1.5-1.5S14 7.67 14 8.5s.67 1.5 1.5 1.5S17 9.33 17 8.5zM20 2h-7v2h7v7h2V4c0-1.1-.9-2-2-2zm0 18h-7v2h7c1.1 0 2-.9 2-2v-7h-2v7zM4 13H2v7c0 1.1.9 2 2 2h7v-2H4v-7z" /><Path d="M0 0h24v24H0z" fill="none" /></SVG>,
 

packages/block-library/src/embed/core-embeds.js

@@ -31,6 +31,7 @@ export const common = [
 			title: 'Twitter',
 			icon: embedTwitterIcon,
 			keywords: [ 'tweet' ],
+			description: __( 'Embed a tweet' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?twitter\.com\/.+/i ],
 	},
@@ -40,6 +41,7 @@ export const common = [
 			title: 'YouTube',
 			icon: embedYouTubeIcon,
 			keywords: [ __( 'music' ), __( 'video' ) ],
+			description: __( 'Embed a YouTube video' ),
 		},
 		patterns: [ /^https?:\/\/((m|www)\.)?youtube\.com\/.+/i, /^https?:\/\/youtu\.be\/.+/i ],
 	},
@@ -48,6 +50,7 @@ export const common = [
 		settings: {
 			title: 'Facebook',
 			icon: embedFacebookIcon,
+			description: __( 'Embed a Facebook post' ),
 		},
 		patterns: [ /^https?:\/\/www\.facebook.com\/.+/i ],
 	},
@@ -57,6 +60,7 @@ export const common = [
 			title: 'Instagram',
 			icon: embedInstagramIcon,
 			keywords: [ __( 'image' ) ],
+			description: __( 'Embed an Instagram post' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?instagr(\.am|am\.com)\/.+/i ],
 	},
@@ -67,6 +71,7 @@ export const common = [
 			icon: embedWordPressIcon,
 			keywords: [ __( 'post' ), __( 'blog' ) ],
 			responsive: false,
+			description: __( 'Embed a WordPress post' ),
 		},
 	},
 	{
@@ -75,6 +80,7 @@ export const common = [
 			title: 'SoundCloud',
 			icon: embedAudioIcon,
 			keywords: [ __( 'music' ), __( 'audio' ) ],
+			description: __( 'Embed SoundCloud content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?soundcloud\.com\/.+/i ],
 	},
@@ -84,6 +90,7 @@ export const common = [
 			title: 'Spotify',
 			icon: embedSpotifyIcon,
 			keywords: [ __( 'music' ), __( 'audio' ) ],
+			description: __( 'Embed Spotify content' ),
 		},
 		patterns: [ /^https?:\/\/(open|play)\.spotify\.com\/.+/i ],
 	},
@@ -93,6 +100,7 @@ export const common = [
 			title: 'Flickr',
 			icon: embedFlickrIcon,
 			keywords: [ __( 'image' ) ],
+			description: __( 'Embed Flickr content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?flickr\.com\/.+/i, /^https?:\/\/flic\.kr\/.+/i ],
 	},
@@ -102,6 +110,7 @@ export const common = [
 			title: 'Vimeo',
 			icon: embedVimeoIcon,
 			keywords: [ __( 'video' ) ],
+			description: __( 'Embed a Vimeo video' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?vimeo\.com\/.+/i ],
 	},
@@ -113,6 +122,7 @@ export const others = [
 		settings: {
 			title: 'Animoto',
 			icon: embedVideoIcon,
+			description: __( 'Embed an Animoto video' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?(animoto|video214)\.com\/.+/i ],
 	},
@@ -121,6 +131,7 @@ export const others = [
 		settings: {
 			title: 'Cloudup',
 			icon: embedContentIcon,
+			description: __( 'Embed Cloudup content' ),
 		},
 		patterns: [ /^https?:\/\/cloudup\.com\/.+/i ],
 	},
@@ -129,6 +140,7 @@ export const others = [
 		settings: {
 			title: 'CollegeHumor',
 			icon: embedVideoIcon,
+			description: __( 'Embed CollegeHumor content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?collegehumor\.com\/.+/i ],
 	},
@@ -137,6 +149,7 @@ export const others = [
 		settings: {
 			title: 'Dailymotion',
 			icon: embedVideoIcon,
+			description: __( 'Embed a Dailymotion video' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?dailymotion\.com\/.+/i ],
 	},
@@ -145,6 +158,7 @@ export const others = [
 		settings: {
 			title: 'Funny or Die',
 			icon: embedVideoIcon,
+			description: __( 'Embed Funny or Die content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?funnyordie\.com\/.+/i ],
 	},
@@ -153,6 +167,7 @@ export const others = [
 		settings: {
 			title: 'Hulu',
 			icon: embedVideoIcon,
+			description: __( 'Embed Hulu content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?hulu\.com\/.+/i ],
 	},
@@ -161,6 +176,7 @@ export const others = [
 		settings: {
 			title: 'Imgur',
 			icon: embedPhotoIcon,
+			description: __( 'Embed Imgur content' ),
 		},
 		patterns: [ /^https?:\/\/(.+\.)?imgur\.com\/.+/i ],
 	},
@@ -169,6 +185,7 @@ export const others = [
 		settings: {
 			title: 'Issuu',
 			icon: embedContentIcon,
+			description: __( 'Embed Issuu content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?issuu\.com\/.+/i ],
 	},
@@ -177,6 +194,7 @@ export const others = [
 		settings: {
 			title: 'Kickstarter',
 			icon: embedContentIcon,
+			description: __( 'Embed Kickstarter content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?kickstarter\.com\/.+/i, /^https?:\/\/kck\.st\/.+/i ],
 	},
@@ -185,6 +203,7 @@ export const others = [
 		settings: {
 			title: 'Meetup.com',
 			icon: embedContentIcon,
+			description: __( 'Embed Meetup.com content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?meetu(\.ps|p\.com)\/.+/i ],
 	},
@@ -194,6 +213,7 @@ export const others = [
 			title: 'Mixcloud',
 			icon: embedAudioIcon,
 			keywords: [ __( 'music' ), __( 'audio' ) ],
+			description: __( 'Embed Mixcloud content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?mixcloud\.com\/.+/i ],
 	},
@@ -202,6 +222,7 @@ export const others = [
 		settings: {
 			title: 'Photobucket',
 			icon: embedPhotoIcon,
+			description: __( 'Embed a Photobucket image' ),
 		},
 		patterns: [ /^http:\/\/g?i*\.photobucket\.com\/.+/i ],
 	},
@@ -210,6 +231,7 @@ export const others = [
 		settings: {
 			title: 'Polldaddy',
 			icon: embedContentIcon,
+			description: __( 'Embed Polldaddy content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?polldaddy\.com\/.+/i ],
 	},
@@ -218,6 +240,7 @@ export const others = [
 		settings: {
 			title: 'Reddit',
 			icon: embedRedditIcon,
+			description: __( 'Embed a Reddit thread' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?reddit\.com\/.+/i ],
 	},
@@ -226,6 +249,7 @@ export const others = [
 		settings: {
 			title: 'ReverbNation',
 			icon: embedAudioIcon,
+			description: __( 'Embed ReverbNation content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?reverbnation\.com\/.+/i ],
 	},
@@ -234,6 +258,7 @@ export const others = [
 		settings: {
 			title: 'Screencast',
 			icon: embedVideoIcon,
+			description: __( 'Embed Screencast content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?screencast\.com\/.+/i ],
 	},
@@ -242,6 +267,7 @@ export const others = [
 		settings: {
 			title: 'Scribd',
 			icon: embedContentIcon,
+			description: __( 'Embed Scribd content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?scribd\.com\/.+/i ],
 	},
@@ -250,6 +276,7 @@ export const others = [
 		settings: {
 			title: 'Slideshare',
 			icon: embedContentIcon,
+			description: __( 'Embed Slideshare content' ),
 		},
 		patterns: [ /^https?:\/\/(.+?\.)?slideshare\.net\/.+/i ],
 	},
@@ -258,6 +285,7 @@ export const others = [
 		settings: {
 			title: 'SmugMug',
 			icon: embedPhotoIcon,
+			description: __( 'Embed SmugMug content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?smugmug\.com\/.+/i ],
 	},
@@ -287,6 +315,7 @@ export const others = [
 					} );
 				},
 			} ],
+			description: __( 'Embed Speaker Deck content' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?speakerdeck\.com\/.+/i ],
 	},
@@ -295,6 +324,7 @@ export const others = [
 		settings: {
 			title: 'TED',
 			icon: embedVideoIcon,
+			description: __( 'Embed a TED video' ),
 		},
 		patterns: [ /^https?:\/\/(www\.|embed\.)?ted\.com\/.+/i ],
 	},
@@ -303,6 +333,7 @@ export const others = [
 		settings: {
 			title: 'Tumblr',
 			icon: embedTumbrIcon,
+			description: __( 'Embed a Tumblr post' ),
 		},
 		patterns: [ /^https?:\/\/(www\.)?tumblr\.com\/.+/i ],
 	},
@@ -312,6 +343,7 @@ export const others = [
 			title: 'VideoPress',
 			icon: embedVideoIcon,
 			keywords: [ __( 'video' ) ],
+			description: __( 'Embed a VideoPress video' ),
 		},
 		patterns: [ /^https?:\/\/videopress\.com\/.+/i ],
 	},
@@ -320,6 +352,7 @@ export const others = [
 		settings: {
 			title: 'WordPress.tv',
 			icon: embedVideoIcon,
+			description: __( 'Embed a WordPress.tv video' ),
 		},
 		patterns: [ /^https?:\/\/wordpress\.tv\/.+/i ],
 	},

packages/block-library/src/heading/index.js

@@ -64,7 +64,7 @@ export const name = 'core/heading';
 export const settings = {
 	title: __( 'Heading' ),
 
-	description: __( 'Introduce new sections and organize content.' ),
+	description: __( 'Introduce new sections and organize content to help visitors (and search engines) understand the structure of your content.' ),
 
 	icon: <SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><Path d="M5 4v3h5.5v12h3V7H19V4z" /><Path fill="none" d="M0 0h24v24H0V0z" /></SVG>,
 

packages/block-library/src/image/index.js

@@ -103,7 +103,7 @@ const schema = {
 export const settings = {
 	title: __( 'Image' ),
 
-	description: __( 'Insert an image for visual color.' ),
+	description: __( 'Insert an image to make a visual statement.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Path d="m19 5v14h-14v-14h14m0-2h-14c-1.1 0-2 0.9-2 2v14c0 1.1 0.9 2 2 2h14c1.1 0 2-0.9 2-2v-14c0-1.1-0.9-2-2-2z" /><Path d="m14.14 11.86l-3 3.87-2.14-2.59-3 3.86h12l-3.86-5.14z" /></SVG>,
 

packages/block-library/src/media-text/index.js

@@ -26,6 +26,8 @@ export const name = 'core/media-text';
 export const settings = {
 	title: __( 'Media & Text' ),
 
+	description: __( 'Set media and words side-by-side media for a richer layout.' ),
+
 	icon: <SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><Path d="M13 17h8v-2h-8v2zM3 19h8V5H3v14zM13 9h8V7h-8v2zm0 4h8v-2h-8v2z" /></SVG>,
 
 	category: 'layout',

packages/block-library/src/quote/index.js

@@ -40,7 +40,7 @@ export const name = 'core/quote';
 
 export const settings = {
 	title: __( 'Quote' ),
-	description: __( 'Give quoted text visual emphasis.' ),
+	description: __( 'Give quoted text visual emphasis. "In quoting others, we cite ourselves." — Julio Cortázar' ),
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M19 18h-6l2-4h-2V6h8v7l-2 5zm-2-2l2-3V8h-4v4h4l-2 4zm-8 2H3l2-4H3V6h8v7l-2 5zm-2-2l2-3V8H5v4h4l-2 4z" /></G></SVG>,
 	category: 'common',
 	keywords: [ __( 'blockquote' ) ],

packages/block-library/src/table/index.js

@@ -77,7 +77,7 @@ export const name = 'core/table';
 
 export const settings = {
 	title: __( 'Table' ),
-	description: __( 'Insert a table -- perfect for sharing charts and data.' ),
+	description: __( 'Insert a table — perfect for sharing charts and data.' ),
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M20 3H5L3 5v14l2 2h15l2-2V5l-2-2zm0 2v3H5V5h15zm-5 14h-5v-9h5v9zM5 10h3v9H5v-9zm12 9v-9h3v9h-3z" /></G></SVG>,
 	category: 'formatting',
 

packages/block-library/src/verse/index.js

@@ -16,7 +16,7 @@ export const name = 'core/verse';
 export const settings = {
 	title: __( 'Verse' ),
 
-	description: __( 'Insert haiku. Use special spacing formats. Or quote song lyrics. (See what we did here?)' ),
+	description: __( 'Insert poetry. Use special spacing formats. Or quote song lyrics.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><Path d="M3 17v4h4l11-11-4-4L3 17zm3 2H5v-1l9-9 1 1-9 9zM21 6l-3-3h-1l-2 2 4 4 2-2V6z" /></SVG>,