Try different block descriptions

This follows the latest suggestions by @alexislloyd in #10919.
WordPress · Oct 30, 2018 · acf7cf5 · acf7cf5
1 parent ca4e9fd
commit acf7cf5
Show file tree

Hide file tree

Showing 25 changed files with 25 additions and 25 deletions.
diff --git a/packages/block-library/src/archives/index.js b/packages/block-library/src/archives/index.js
@@ -14,7 +14,7 @@ export const name = 'core/archives';
 export const settings = {
 	title: __( 'Archives' ),
 
-	description: __( 'Display a monthly archive of your site’s Posts.' ),
+	description: __( 'Display a monthly archive of your posts.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M7 11h2v2H7v-2zm14-5v14l-2 2H5l-2-2V6l2-2h1V2h2v2h8V2h2v2h1l2 2zM5 8h14V6H5v2zm14 12V10H5v10h14zm-4-7h2v-2h-2v2zm-4 0h2v-2h-2v2z" /></G></SVG>,
 

diff --git a/packages/block-library/src/audio/index.js b/packages/block-library/src/audio/index.js
@@ -17,7 +17,7 @@ export const name = 'core/audio';
 export const settings = {
 	title: __( 'Audio' ),
 
-	description: __( 'Embed an audio file and a simple audio player.' ),
+	description: __( 'Embed a simple audio player.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Path d="m12 3l0.01 10.55c-0.59-0.34-1.27-0.55-2-0.55-2.22 0-4.01 1.79-4.01 4s1.79 4 4.01 4 3.99-1.79 3.99-4v-10h4v-4h-6zm-1.99 16c-1.1 0-2-0.9-2-2s0.9-2 2-2 2 0.9 2 2-0.9 2-2 2z" /></SVG>,
 

diff --git a/packages/block-library/src/button/index.js b/packages/block-library/src/button/index.js
@@ -64,7 +64,7 @@ const colorsMigration = ( attributes ) => {
 export const settings = {
 	title: __( 'Button' ),
 
-	description: __( 'Want visitors to click to subscribe, buy, or read more? Get their attention with a button.' ),
+	description: __( 'Prompt visitors to take action with a custom button.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M19 6H5L3 8v8l2 2h14l2-2V8l-2-2zm0 10H5V8h14v8z" /></G></SVG>,
 

diff --git a/packages/block-library/src/categories/index.js b/packages/block-library/src/categories/index.js
@@ -14,7 +14,7 @@ export const name = 'core/categories';
 export const settings = {
 	title: __( 'Categories' ),
 
-	description: __( 'Display a list of all your site’s categories.' ),
+	description: __( 'Display a list of all categories.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Path d="M12,2l-5.5,9h11L12,2z M12,5.84L13.93,9h-3.87L12,5.84z" /><Path d="m17.5 13c-2.49 0-4.5 2.01-4.5 4.5s2.01 4.5 4.5 4.5 4.5-2.01 4.5-4.5-2.01-4.5-4.5-4.5zm0 7c-1.38 0-2.5-1.12-2.5-2.5s1.12-2.5 2.5-2.5 2.5 1.12 2.5 2.5-1.12 2.5-2.5 2.5z" /><Path d="m3 21.5h8v-8h-8v8zm2-6h4v4h-4v-4z" /></SVG>,
 

diff --git a/packages/block-library/src/classic/index.js b/packages/block-library/src/classic/index.js
@@ -15,7 +15,7 @@ export const name = 'core/freeform';
 export const settings = {
 	title: _x( 'Classic', 'block title' ),
 
-	description: __( 'It’s the classic WordPress editor and it’s a block! Drop the editor right in.' ),
+	description: __( 'Use the classic WordPress editor.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z M0,0h24v24H0V0z" fill="none" /><Path d="m20 7v10h-16v-10h16m0-2h-16c-1.1 0-1.99 0.9-1.99 2l-0.01 10c0 1.1 0.9 2 2 2h16c1.1 0 2-0.9 2-2v-10c0-1.1-0.9-2-2-2z" /><Rect x="11" y="8" width="2" height="2" /><Rect x="11" y="11" width="2" height="2" /><Rect x="8" y="8" width="2" height="2" /><Rect x="8" y="11" width="2" height="2" /><Rect x="5" y="11" width="2" height="2" /><Rect x="5" y="8" width="2" height="2" /><Rect x="8" y="14" width="8" height="2" /><Rect x="14" y="11" width="2" height="2" /><Rect x="14" y="8" width="2" height="2" /><Rect x="17" y="11" width="2" height="2" /><Rect x="17" y="8" width="2" height="2" /></SVG>,
 

diff --git a/packages/block-library/src/code/index.js b/packages/block-library/src/code/index.js
@@ -18,7 +18,7 @@ export const name = 'core/code';
 export const settings = {
 	title: __( 'Code' ),
 
-	description: __( 'Add text that respects your spacing and tabs -- perfect for displaying code.' ),
+	description: __( 'Display code snippets that respect your spacing and tabs.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Path d="M9.4,16.6L4.8,12l4.6-4.6L8,6l-6,6l6,6L9.4,16.6z M14.6,16.6l4.6-4.6l-4.6-4.6L16,6l6,6l-6,6L14.6,16.6z" /></SVG>,
 

diff --git a/packages/block-library/src/embed/index.js b/packages/block-library/src/embed/index.js
@@ -15,7 +15,7 @@ export const name = 'core/embed';
 
 export const settings = getEmbedBlockSettings( {
 	title: _x( 'Embed', 'block title' ),
-	description: __( 'The Embed block allows you to easily add videos, images, tweets, audio, and other content to your post or page.' ),
+	description: __( 'Embed videos, images, tweets, audio, and other content from external sources.' ),
 	icon: embedContentIcon,
 	// Unknown embeds should not be responsive by default.
 	responsive: false,

diff --git a/packages/block-library/src/file/index.js b/packages/block-library/src/file/index.js
@@ -23,7 +23,7 @@ export const name = 'core/file';
 export const settings = {
 	title: __( 'File' ),
 
-	description: __( 'Add a link to a file that visitors can download.' ),
+	description: __( 'Add a link to a downloadable file.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><Path d="M9 6l2 2h9v10H4V6h5m1-2H4L2 6v12l2 2h16l2-2V8l-2-2h-8l-2-2z" /></SVG>,
 

diff --git a/packages/block-library/src/gallery/index.js b/packages/block-library/src/gallery/index.js
@@ -69,7 +69,7 @@ export const name = 'core/gallery';
 
 export const settings = {
 	title: __( 'Gallery' ),
-	description: __( 'Display multiple images in an elegantly organized tiled layout.' ),
+	description: __( 'Display multiple images in a rich gallery.' ),
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M20 4v12H8V4h12m0-2H8L6 4v12l2 2h12l2-2V4l-2-2z" /><Path d="M12 12l1 2 3-3 3 4H9z" /><Path d="M2 6v14l2 2h14v-2H4V6H2z" /></G></SVG>,
 	category: 'common',
 	keywords: [ __( 'images' ), __( 'photos' ) ],

diff --git a/packages/block-library/src/heading/index.js b/packages/block-library/src/heading/index.js
@@ -64,7 +64,7 @@ export const name = 'core/heading';
 export const settings = {
 	title: __( 'Heading' ),
 
-	description: __( 'Introduce topics and help visitors (and search engines!) understand how your content is organized.' ),
+	description: __( 'Introduce new sections and organize 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>,
 

diff --git a/packages/block-library/src/html/index.js b/packages/block-library/src/html/index.js
@@ -13,7 +13,7 @@ export const name = 'core/html';
 export const settings = {
 	title: __( 'Custom HTML' ),
 
-	description: __( 'Add your own HTML (and view it right here as you edit!).' ),
+	description: __( 'Add custom HTML code and preview it as you edit.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M4.5,11h-2V9H1v6h1.5v-2.5h2V15H6V9H4.5V11z M7,10.5h1.5V15H10v-4.5h1.5V9H7V10.5z M14.5,10l-1-1H12v6h1.5v-3.9  l1,1l1-1V15H17V9h-1.5L14.5,10z M19.5,13.5V9H18v6h5v-1.5H19.5z" /></SVG>,
 

diff --git a/packages/block-library/src/image/index.js b/packages/block-library/src/image/index.js
@@ -103,7 +103,7 @@ const schema = {
 export const settings = {
 	title: __( 'Image' ),
 
-	description: __( 'They’re worth 1,000 words! Insert a single image.' ),
+	description: __( 'Insert an image for visual color.' ),
 
 	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>,
 

diff --git a/packages/block-library/src/latest-comments/index.js b/packages/block-library/src/latest-comments/index.js
@@ -14,7 +14,7 @@ export const name = 'core/latest-comments';
 export const settings = {
 	title: __( 'Latest Comments' ),
 
-	description: __( 'Show a list of your site’s most recent comments.' ),
+	description: __( 'Display a list of your most recent comments.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M22 4l-2-2H4L2 4v12l2 2h14l4 4V4zm-2 0v13l-1-1H4V4h16z" /><Path d="M6 12h12v2H6zM6 9h12v2H6zM6 6h12v2H6z" /></G></SVG>,
 

diff --git a/packages/block-library/src/list/index.js b/packages/block-library/src/list/index.js
@@ -60,7 +60,7 @@ export const name = 'core/list';
 
 export const settings = {
 	title: __( 'List' ),
-	description: __( 'Numbers, bullets, up to you. Add a list of items.' ),
+	description: __( 'Create a bulleted or numbered list.' ),
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><G><Path d="M9 19h12v-2H9v2zm0-6h12v-2H9v2zm0-8v2h12V5H9zm-4-.5c-.828 0-1.5.672-1.5 1.5S4.172 7.5 5 7.5 6.5 6.828 6.5 6 5.828 4.5 5 4.5zm0 6c-.828 0-1.5.672-1.5 1.5s.672 1.5 1.5 1.5 1.5-.672 1.5-1.5-.672-1.5-1.5-1.5zm0 6c-.828 0-1.5.672-1.5 1.5s.672 1.5 1.5 1.5 1.5-.672 1.5-1.5-.672-1.5-1.5-1.5z" /></G></SVG>,
 	category: 'common',
 	keywords: [ __( 'bullet list' ), __( 'ordered list' ), __( 'numbered list' ) ],

diff --git a/packages/block-library/src/more/index.js b/packages/block-library/src/more/index.js
@@ -25,7 +25,7 @@ export const name = 'core/more';
 export const settings = {
 	title: _x( 'More', 'block name' ),
 
-	description: __( 'Want to show only part of this post on your blog’s home page? Insert a "More" block where you want the split.' ),
+	description: __( 'Want to show only an excerpt of this post on your home page? Use this block to define where you want the separation.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><G><Path d="M2 9v2h19V9H2zm0 6h5v-2H2v2zm7 0h5v-2H9v2zm7 0h5v-2h-5v2z" /></G></SVG>,
 

diff --git a/packages/block-library/src/nextpage/index.js b/packages/block-library/src/nextpage/index.js
@@ -11,7 +11,7 @@ export const name = 'core/nextpage';
 export const settings = {
 	title: __( 'Page break' ),
 
-	description: __( 'This block allows you to set break points on your post. Visitors of your blog are then presented with content split into multiple pages.' ),
+	description: __( 'Separate your content into a multi-page experience.' ),
 
 	icon: <SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><G><Path d="M9 12h6v-2H9zm-7 0h5v-2H2zm15 0h5v-2h-5zm3 2v2l-6 6H6a2 2 0 0 1-2-2v-6h2v6h6v-4a2 2 0 0 1 2-2h6zM4 8V4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v4h-2V4H6v4z" /></G></SVG>,
 

diff --git a/packages/block-library/src/paragraph/index.js b/packages/block-library/src/paragraph/index.js
@@ -77,7 +77,7 @@ export const name = 'core/paragraph';
 export const settings = {
 	title: __( 'Paragraph' ),
 
-	description: __( 'Add some basic text.' ),
+	description: __( 'Start with the building block of all narrative.' ),
 
 	icon: <SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><Path d="M11 5v7H9.5C7.6 12 6 10.4 6 8.5S7.6 5 9.5 5H11m8-2H9.5C6.5 3 4 5.5 4 8.5S6.5 14 9.5 14H11v7h2V5h2v16h2V5h2V3z" /></SVG>,
 

diff --git a/packages/block-library/src/preformatted/index.js b/packages/block-library/src/preformatted/index.js
@@ -11,7 +11,7 @@ export const name = 'core/preformatted';
 export const settings = {
 	title: __( 'Preformatted' ),
 
-	description: __( 'Add text that respects your spacing and tabs, and also allows styling.' ),
+	description: __( 'Add custom HTML code and preview it as you edit.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Path d="M20,4H4C2.9,4,2,4.9,2,6v12c0,1.1,0.9,2,2,2h16c1.1,0,2-0.9,2-2V6C22,4.9,21.1,4,20,4z M20,18H4V6h16V18z" /><Rect x="6" y="10" width="2" height="2" /><Rect x="6" y="14" width="8" height="2" /><Rect x="16" y="14" width="2" height="2" /><Rect x="10" y="10" width="8" height="2" /></SVG>,
 

diff --git a/packages/block-library/src/pullquote/index.js b/packages/block-library/src/pullquote/index.js
@@ -57,7 +57,7 @@ export const settings = {
 
 	title: __( 'Pullquote' ),
 
-	description: __( 'Highlight a quote from your post or page by displaying it as a graphic element.' ),
+	description: __( 'Give special visual emphasis to a quote from your text.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M0,0h24v24H0V0z" fill="none" /><Polygon points="21 18 2 18 2 20 21 20" /><Path d="m19 10v4h-15v-4h15m1-2h-17c-0.55 0-1 0.45-1 1v6c0 0.55 0.45 1 1 1h17c0.55 0 1-0.45 1-1v-6c0-0.55-0.45-1-1-1z" /><Polygon points="21 4 2 4 2 6 21 6" /></SVG>,
 

diff --git a/packages/block-library/src/quote/index.js b/packages/block-library/src/quote/index.js
@@ -40,7 +40,7 @@ export const name = 'core/quote';
 
 export const settings = {
 	title: __( 'Quote' ),
-	description: __( 'Maybe someone else said it better -- add some quoted text.' ),
+	description: __( 'Give quoted text visual emphasis.' ),
 	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' ) ],

diff --git a/packages/block-library/src/separator/index.js b/packages/block-library/src/separator/index.js
@@ -10,7 +10,7 @@ export const name = 'core/separator';
 export const settings = {
 	title: __( 'Separator' ),
 
-	description: __( 'Insert a horizontal line where you want to create a break between ideas.' ),
+	description: __( 'Create a break between ideas or sections with a horizontal line.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><Path d="M19 13H5v-2h14v2z" /></SVG>,
 

diff --git a/packages/block-library/src/shortcode/index.js b/packages/block-library/src/shortcode/index.js
@@ -13,7 +13,7 @@ export const name = 'core/shortcode';
 export const settings = {
 	title: __( 'Shortcode' ),
 
-	description: __( 'Add a shortcode -- a WordPress-specific snippet of code written between square brackets.' ),
+	description: __( 'Insert additional custom elements with a WordPress shortcode.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path d="M8.5,21.4l1.9,0.5l5.2-19.3l-1.9-0.5L8.5,21.4z M3,19h4v-2H5V7h2V5H3V19z M17,5v2h2v10h-2v2h4V5H17z" /></SVG>,
 

diff --git a/packages/block-library/src/spacer/index.js b/packages/block-library/src/spacer/index.js
@@ -17,7 +17,7 @@ export const name = 'core/spacer';
 export const settings = {
 	title: __( 'Spacer' ),
 
-	description: __( 'Add an element with empty space and custom height.' ),
+	description: __( 'Add white space between blocks and customize its height.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><G><Path d="M13 4v2h3.59L6 16.59V13H4v7h7v-2H7.41L18 7.41V11h2V4h-7" /></G></SVG>,
 

diff --git a/packages/block-library/src/verse/index.js b/packages/block-library/src/verse/index.js
@@ -16,7 +16,7 @@ export const name = 'core/verse';
 export const settings = {
 	title: __( 'Verse' ),
 
-	description: __( 'A block for haiku? Why not? Blocks for all the things! (See what we did here?)' ),
+	description: __( 'Insert haiku. Use special spacing formats. Or quote song lyrics. (See what we did here?)' ),
 
 	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>,
 

diff --git a/packages/block-library/src/video/index.js b/packages/block-library/src/video/index.js
@@ -17,7 +17,7 @@ export const name = 'core/video';
 export const settings = {
 	title: __( 'Video' ),
 
-	description: __( 'Embed a video file and a simple video player.' ),
+	description: __( 'Embed a video from your media library or upload a new one.' ),
 
 	icon: <SVG viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><Path fill="none" d="M0 0h24v24H0V0z" /><Path d="M4 6l2 4h14v8H4V6m18-2h-4l2 4h-3l-2-4h-2l2 4h-3l-2-4H8l2 4H7L5 4H4L2 6v12l2 2h16l2-2V4z" /></SVG>,