Adds better descriptions for all blocks (#6624)

Iterates on descriptions and audits them all as a result.

Props @michelleweber. Fixes #6623

core-blocks/audio/index.js

@@ -15,7 +15,7 @@ export const name = 'core/audio';
 export const settings = {
 	title: __( 'Audio' ),
 
-	description: __( 'The Audio block allows you to embed audio files and play them back using a simple player.' ),
+	description: __( 'Embed an audio file and a simple audio player.' ),
 
 	icon: 'format-audio',
 

core-blocks/button/index.js

@@ -68,7 +68,7 @@ const colorsMigration = ( attributes ) => {
 export const settings = {
 	title: __( 'Button' ),
 
-	description: __( 'A nice little button. Call something out with it.' ),
+	description: __( 'Want visitors to click to subscribe, buy, or read more? Get their attention with a button.' ),
 
 	icon: 'button',
 

core-blocks/categories/index.js

@@ -14,7 +14,7 @@ export const name = 'core/categories';
 export const settings = {
 	title: __( 'Categories' ),
 
-	description: __( 'Shows a list of your site\'s categories.' ),
+	description: __( 'Display a list of all your site\'s categories.' ),
 
 	icon: 'list-view',
 

core-blocks/code/index.js

@@ -14,7 +14,7 @@ export const name = 'core/code';
 export const settings = {
 	title: __( 'Code' ),
 
-	description: __( 'The code block maintains spaces and tabs, great for showing code snippets.' ),
+	description: __( 'Add text that respects your spacing and tabs -- perfect for displaying code.' ),
 
 	icon: 'editor-code',
 

core-blocks/columns/index.js

@@ -58,7 +58,7 @@ export const settings = {
 		},
 	},
 
-	description: __( 'A multi-column layout of content.' ),
+	description: __( 'Add a block that displays content in multiple columns, then add whatever content blocks you\'d like.' ),
 
 	supports: {
 		align: [ 'wide', 'full' ],

core-blocks/cover-image/index.js

@@ -63,7 +63,7 @@ export const name = 'core/cover-image';
 export const settings = {
 	title: __( 'Cover Image' ),
 
-	description: __( 'Cover Image is a bold image block with an optional title.' ),
+	description: __( 'Add a full-width image, and layer text over it -- great for headers.' ),
 
 	icon: 'cover-image',
 

core-blocks/embed/index.js

@@ -30,7 +30,7 @@ const HOSTS_NO_PREVIEWS = [ 'facebook.com' ];
 
 function getEmbedBlockSettings( { title, description, icon, category = 'embed', transforms, keywords = [] } ) {
 	// translators: %s: Name of service (e.g. VideoPress, YouTube)
-	const blockDescription = description || sprintf( __( 'Paste URLs from %s to embed the content in this block' ), title );
+	const blockDescription = description || sprintf( __( 'Add a block that displays content pulled from other sites, like Twitter, Instagram or YouTube.' ), title );
 	return {
 		title,
 		description: blockDescription,

core-blocks/freeform/index.js

@@ -15,7 +15,7 @@ export const name = 'core/freeform';
 export const settings = {
 	title: __( 'Classic' ),
 
-	description: __( 'The classic editor, in block form.' ),
+	description: __( 'It\'s the classic WordPress editor and it\'s block! Drop the editor right in.' ),
 
 	icon: 'editor-kitchensink',
 

core-blocks/gallery/index.js

@@ -76,7 +76,7 @@ export const name = 'core/gallery';
 
 export const settings = {
 	title: __( 'Gallery' ),
-	description: __( 'Image galleries are a great way to share groups of pictures on your site.' ),
+	description: __( 'Display multiple images in an elegantly organized tiled layout.' ),
 	icon: 'format-gallery',
 	category: 'common',
 	keywords: [ __( 'images' ), __( 'photos' ) ],

core-blocks/heading/index.js

@@ -16,7 +16,7 @@ export const name = 'core/heading';
 export const settings = {
 	title: __( 'Heading' ),
 
-	description: __( 'Search engines use the headings to index the structure and content of your web pages.' ),
+	description: __( 'Insert a headline above your post or page content.' ),
 
 	icon: 'heading',
 

core-blocks/html/index.js

@@ -17,7 +17,7 @@ export const name = 'core/html';
 export const settings = {
 	title: __( 'Custom HTML' ),
 
-	description: __( 'Add custom HTML code and preview it right here in the editor.' ),
+	description: __( 'Add your own HTML (and view it right here as you edit!).' ),
 
 	icon: 'html',
 

core-blocks/image/index.js

@@ -84,7 +84,7 @@ const schema = {
 export const settings = {
 	title: __( 'Image' ),
 
-	description: __( 'Worth a thousand words.' ),
+	description: __( 'They\'re worth 1,000 words! Insert a single image.' ),
 
 	icon: 'format-image',
 

core-blocks/latest-posts/index.js

@@ -15,7 +15,7 @@ export const name = 'core/latest-posts';
 export const settings = {
 	title: __( 'Latest Posts' ),
 
-	description: __( 'Shows a list of your site\'s most recent posts.' ),
+	description: __( 'Display a list of your most recent posts.' ),
 
 	icon: 'list-view',
 

core-blocks/list/index.js

@@ -40,7 +40,7 @@ export const name = 'core/list';
 
 export const settings = {
 	title: __( 'List' ),
-	description: __( 'List. Numbered or bulleted.' ),
+	description: __( 'Numbers, bullets, up to you. Add a list of items.' ),
 	icon: 'editor-ul',
 	category: 'common',
 	keywords: [ __( 'bullet list' ), __( 'ordered list' ), __( 'numbered list' ) ],

core-blocks/more/index.js

@@ -20,7 +20,7 @@ export const name = 'core/more';
 export const settings = {
 	title: __( 'More' ),
 
-	description: __( '"More" allows you to break your post into a part shown on index pages, and the subsequent after clicking a "Read More" link.' ),
+	description: __( 'Want to show only part of this post on your blog\'s home page? Insert a "More" block where you want the split.' ),
 
 	icon: 'editor-insertmore',
 

core-blocks/paragraph/index.js

@@ -313,7 +313,7 @@ export const name = 'core/paragraph';
 export const settings = {
 	title: __( 'Paragraph' ),
 
-	description: __( 'This is a simple text only block for adding a single paragraph of content.' ),
+	description: __( 'Add some basic text.' ),
 
 	icon: 'editor-paragraph',
 

core-blocks/preformatted/index.js

@@ -15,7 +15,7 @@ export const name = 'core/preformatted';
 export const settings = {
 	title: __( 'Preformatted' ),
 
-	description: __( 'Preformatted text keeps your spaces, tabs and linebreaks as they are.' ),
+	description: __( 'Add text that respects your spacing and tabs, and also allows styling.' ),
 
 	icon: 'text',
 

core-blocks/pullquote/index.js

@@ -52,7 +52,7 @@ export const settings = {
 
 	title: __( 'Pullquote' ),
 
-	description: __( 'A pullquote is a brief, attention-catching quotation taken from the main text of an article and used as a subheading or graphic feature.' ),
+	description: __( 'Highlight a quote from your post or page by displaying it as a graphic element.' ),
 
 	icon: 'format-quote',
 

core-blocks/quote/index.js

@@ -58,7 +58,7 @@ export const name = 'core/quote';
 
 export const settings = {
 	title: __( 'Quote' ),
-	description: __( 'Quote. In quoting others, we cite ourselves. (Julio Cortázar)' ),
+	description: __( 'Maybe someone else said it better -- add some quoted text.' ),
 	icon: 'format-quote',
 	category: 'common',
 

core-blocks/separator/index.js

@@ -14,7 +14,7 @@ export const name = 'core/separator';
 export const settings = {
 	title: __( 'Separator' ),
 
-	description: __( 'Use the separator to indicate a thematic change in the content.' ),
+	description: __( 'Insert a horizontal line where you want to create a break between ideas.' ),
 
 	icon: 'minus',
 

core-blocks/shortcode/index.js

@@ -16,7 +16,7 @@ export const name = 'core/shortcode';
 export const settings = {
 	title: __( 'Shortcode' ),
 
-	description: __( 'A shortcode is a WordPress-specific code snippet that is written between square brackets as [shortcode]. ' ),
+	description: __( 'Add a shortcode -- a WordPress-specific snippet of code written between square brackets.' ),
 
 	icon: 'shortcode',
 

core-blocks/subhead/index.js

@@ -16,7 +16,7 @@ export const name = 'core/subhead';
 export const settings = {
 	title: __( 'Subhead' ),
 
-	description: __( 'Explanatory text under the main heading of an article.' ),
+	description: __( 'What\'s a subhead? Smaller than a headline, bigger than basic text.' ),
 
 	icon: 'text',
 

core-blocks/table/index.js

@@ -54,7 +54,7 @@ export const name = 'core/table';
 
 export const settings = {
 	title: __( 'Table' ),
-	description: __( 'Tables. Best used for tabular data.' ),
+	description: __( 'Insert a table -- perfect for sharing charts and data.' ),
 	icon: 'editor-table',
 	category: 'formatting',
 

core-blocks/text-columns/index.js

@@ -27,7 +27,7 @@ export const name = 'core/text-columns';
 export const settings = {
 	title: __( 'Text Columns' ),
 
-	description: __( 'Add text across columns. This block is experimental' ),
+	description: __( 'Add text, and display it in two or more columns. Like a newspaper! This block is experimental.' ),
 
 	icon: 'columns',
 

core-blocks/verse/index.js

@@ -15,7 +15,7 @@ export const name = 'core/verse';
 export const settings = {
 	title: __( 'Verse' ),
 
-	description: __( 'Write poetry and other literary expressions honoring all spaces and line-breaks.' ),
+	description: __( 'A block for haiku? Why not? Blocks for all the things! (See what we did here?)' ),
 
 	icon: 'edit',
 

core-blocks/video/index.js

@@ -33,7 +33,7 @@ export const name = 'core/video';
 export const settings = {
 	title: __( 'Video' ),
 
-	description: __( 'The Video block allows you to embed video files and play them back using a simple player.' ),
+	description: __( 'Embed an video file and a simple video player.' ),
 
 	icon: 'format-video',