Add a description to the Site Title block. #23462
Conversation
mtias
added
Needs Design Feedback
|
Is there a description at the moment, or is this thread to figure out what the description should be? |
|
Size Change: +89 B (0%) Total Size: 1.18 MB
ℹ️ View Unchanged
|
|
@michelleweber currently there's no description, this PR adds one. |
| @@ -15,6 +15,9 @@ export { metadata, name }; | |||
|
|
|||
| export const settings = { | |||
| title: __( 'Site Title' ), | |||
| description: __( | |||
| 'The name of the site is an important setting that determines how the website is displayed in various places, including the title bar of a web browser, search engine results, and RSS feeds. It can also be edited in Settings > General.' | |||
There was a problem hiding this comment.
Because many of the core blocks start with words like "Introduce," "add," and "Insert," perhaps something similar could work here:
Display the title of your site — perfect for your site header.
|
Hello! I'll be jumping in on this one for @michelleweber. Ping me when you're ready! I'm standing by. |
|
Here's a few ideas, shown in context to get a sense for sizing and how it affects the layout:
Here's the options typed out to make them easier to read and copy/paste: -- Your site's title is shown in various places including search engine results, bookmarks, the browser's title bar, and more. You can also edit your site's title in Settings > General. -- The name of your site that appears in the browser title bar, in search results, and more. -- The name of your site that appears in the browser title bar, in search results, and more. Also available in Settings > General -- |
|
@shaunandrews Most of the blocks descriptions start with verbs like "add," "insert," "use," etc. Should we stick to that convention here? (I think only a handful of people will notice) That's why I suggested something like:
|
I don't have a strong opinion; Starting with "Display..." seems to imply that you wouldn't be able to edit the site title. If you can edit, then I think its important to mention that the contents of this block are used in many other places. |
|
The description needs to indicate that the site title is a link on the front, because it is not obvious in the editor. |
mtias
force-pushed
the
add/site-title-block-description
branch
from
b982e4c to
b03aafc
Compare
Block descriptions are a crucial pieces of information to teach users about the different aspects of a site. We should pay extra care in crafting them.