diff --git a/package-lock.json b/package-lock.json index 06884a9869123..ed71b4aeeb431 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2443,6 +2443,7 @@ "requires": { "@babel/runtime": "^7.0.0", "@wordpress/data": "file:packages/data", + "@wordpress/deprecated": "file:packages/deprecated", "@wordpress/escape-html": "file:packages/escape-html", "lodash": "^4.17.10", "rememo": "^3.0.0" diff --git a/packages/block-library/src/archives/index.js b/packages/block-library/src/archives/index.js index e978f7d640341..8dfca64a8823c 100644 --- 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: , diff --git a/packages/block-library/src/audio/index.js b/packages/block-library/src/audio/index.js index 3161bb22e61c0..51a307102397d 100644 --- 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: , diff --git a/packages/block-library/src/button/index.js b/packages/block-library/src/button/index.js index 24531e39eb42a..5dddccfa760ca 100644 --- 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: , diff --git a/packages/block-library/src/categories/index.js b/packages/block-library/src/categories/index.js index a51d734c33072..ab9c198eff461 100644 --- 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: , diff --git a/packages/block-library/src/classic/index.js b/packages/block-library/src/classic/index.js index a8fd64e08daa0..e30d7fa75eada 100644 --- 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: , diff --git a/packages/block-library/src/code/index.js b/packages/block-library/src/code/index.js index badc677610aae..cb304079e1e2c 100644 --- 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: , diff --git a/packages/block-library/src/cover/index.js b/packages/block-library/src/cover/index.js index 4004dfa17bdb8..b282c5c7aeb8e 100644 --- a/packages/block-library/src/cover/index.js +++ b/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: , diff --git a/packages/block-library/src/embed/core-embeds.js b/packages/block-library/src/embed/core-embeds.js index 004166d227c2f..a38c47d5be21b 100644 --- a/packages/block-library/src/embed/core-embeds.js +++ b/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 ], }, diff --git a/packages/block-library/src/embed/index.js b/packages/block-library/src/embed/index.js index 4331e331c555d..7bf859a002373 100644 --- 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 index 51252abf20580..7f26a4abc025e 100644 --- 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: , diff --git a/packages/block-library/src/gallery/index.js b/packages/block-library/src/gallery/index.js index 1b24c82461ab6..e347c806d2af3 100644 --- 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: , category: 'common', keywords: [ __( 'images' ), __( 'photos' ) ], diff --git a/packages/block-library/src/heading/index.js b/packages/block-library/src/heading/index.js index 4772818bd238d..6f98add18effe 100644 --- 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 to help visitors (and search engines) understand the structure of your content.' ), icon: , diff --git a/packages/block-library/src/html/index.js b/packages/block-library/src/html/index.js index 5243df8962f49..c7307aa53e9b4 100644 --- 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: , diff --git a/packages/block-library/src/image/index.js b/packages/block-library/src/image/index.js index 00ea17c772cfe..83a022388d35d 100644 --- 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 to make a visual statement.' ), icon: , diff --git a/packages/block-library/src/latest-comments/index.js b/packages/block-library/src/latest-comments/index.js index 61310f4ebda14..d7420744d0011 100644 --- 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: , diff --git a/packages/block-library/src/list/index.js b/packages/block-library/src/list/index.js index c5683dc5fe82d..e7c38a543f56b 100644 --- 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: , category: 'common', keywords: [ __( 'bullet list' ), __( 'ordered list' ), __( 'numbered list' ) ], diff --git a/packages/block-library/src/media-text/index.js b/packages/block-library/src/media-text/index.js index 14a3a3281f093..d82d86228091e 100644 --- a/packages/block-library/src/media-text/index.js +++ b/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: , category: 'layout', diff --git a/packages/block-library/src/more/index.js b/packages/block-library/src/more/index.js index a42f1025723c0..9334ed2e0941c 100644 --- 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: , diff --git a/packages/block-library/src/nextpage/index.js b/packages/block-library/src/nextpage/index.js index f5d35e4eb3073..02114bd72c078 100644 --- 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: , diff --git a/packages/block-library/src/paragraph/index.js b/packages/block-library/src/paragraph/index.js index 6465c43e48391..e315f551cc9f3 100644 --- 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: , diff --git a/packages/block-library/src/pullquote/index.js b/packages/block-library/src/pullquote/index.js index 3693fc2db2190..1dc6126394678 100644 --- 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: , diff --git a/packages/block-library/src/quote/index.js b/packages/block-library/src/quote/index.js index bd226c2bc9a7f..a87b0dba27453 100644 --- 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. "In quoting others, we cite ourselves." — Julio Cortázar' ), icon: , category: 'common', keywords: [ __( 'blockquote' ) ], diff --git a/packages/block-library/src/separator/index.js b/packages/block-library/src/separator/index.js index a85576d97b3ad..f077d6533413d 100644 --- 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 separator.' ), icon: , diff --git a/packages/block-library/src/shortcode/index.js b/packages/block-library/src/shortcode/index.js index e5fd517798d6c..06464c52e7082 100644 --- 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: , diff --git a/packages/block-library/src/spacer/index.js b/packages/block-library/src/spacer/index.js index 6b66cf4eadd53..12f362b40f623 100644 --- 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: , diff --git a/packages/block-library/src/table/index.js b/packages/block-library/src/table/index.js index a3fb8d91590f8..aff5c7ca5be8c 100644 --- a/packages/block-library/src/table/index.js +++ b/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: , category: 'formatting', diff --git a/packages/block-library/src/verse/index.js b/packages/block-library/src/verse/index.js index c5072386553c8..e70bc44550735 100644 --- 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 poetry. Use special spacing formats. Or quote song lyrics.' ), icon: , diff --git a/packages/block-library/src/video/index.js b/packages/block-library/src/video/index.js index 8947158c46781..ac20d15dcaa33 100644 --- 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: ,