diff --git a/packages/block-library/src/post-template/block.json b/packages/block-library/src/post-template/block.json index e4d5de82815147..7ac5910941d76f 100644 --- a/packages/block-library/src/post-template/block.json +++ b/packages/block-library/src/post-template/block.json @@ -4,7 +4,7 @@ "title": "Post Template", "category": "design", "parent": [ "core/query" ], - "description": "Post Template.", + "description": "Contains the block elements used to render a post, like the title, date, featured image, content or excerpt, and more.", "textdomain": "default", "usesContext": [ "queryId", diff --git a/packages/block-library/src/query/block.json b/packages/block-library/src/query/block.json index a08dbc2e1326e7..01869ae6ea6cf0 100644 --- a/packages/block-library/src/query/block.json +++ b/packages/block-library/src/query/block.json @@ -3,7 +3,7 @@ "name": "core/query", "title": "Query Loop", "category": "design", - "description": "Displays a list of posts as a result of a query.", + "description": "An advanced block that allows displaying post types based on different query parameters and visual configurations.", "textdomain": "default", "attributes": { "queryId": { diff --git a/packages/block-library/src/query/edit/query-inspector-controls.js b/packages/block-library/src/query/edit/query-inspector-controls.js index 315b18d499dc62..c4dd6947221030 100644 --- a/packages/block-library/src/query/edit/query-inspector-controls.js +++ b/packages/block-library/src/query/edit/query-inspector-controls.js @@ -178,9 +178,9 @@ export default function QueryInspectorControls( { setQuery( { inherit: !! value } ) } @@ -191,6 +191,9 @@ export default function QueryInspectorControls( { value={ postType } label={ __( 'Post Type' ) } onChange={ onPostTypeChange } + help={ __( + 'WordPress contains different types of content and they are divided into collections called "Post Types". By default there are a few different ones such as blog posts and pages, but plugins could add more.' + ) } /> ) } { displayLayout?.type === 'flex' && ( @@ -230,6 +233,9 @@ export default function QueryInspectorControls( { options={ stickyOptions } value={ sticky } onChange={ ( value ) => setQuery( { sticky: value } ) } + help={ __( + 'Blog posts can be "stickied", a feature that places them at the top of the front page of posts, keeping it there until new sticky posts are published.' + ) } /> ) }