-
Notifications
You must be signed in to change notification settings - Fork 4.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update template descriptions with more detail #48934
Conversation
I left a comment on the issue, pasting in here: 404The 'typo' part is a little ambiguous... when the user makes a typo where, adding a comment, logging in, searching? Should we embellish that, or maybe get rid of it? AttachmentIt feels a little overly technical / jargony. Do we need that "uploaded to a post" part at the end?
Home
Should 'for' be 'as'?
What do you think @justintadlock ? |
Size Change: +9 B (0%) Total Size: 1.34 MB
ℹ️ View Unchanged
|
@ntsekouras I'm still seeing the old descriptions for Index and Taxonomy 🤔 The rest are working well. |
Hm.. you shouldn't. I'm seeing the new ones.. |
on 404 - "Displays when a visitor views a non-existant page, such as a dead link or when the visitor makes a typo." better, maybe "...such as a dead link or a mistyped URL ? |
That seems good to me @bph :) @ntsekouras could something like this be cached? 🤔 descriptions.mp4 |
This is saved in the template. If a template didn't exist in a theme(like |
Tested well for me and all the strings look correct when compared with the original list, and subsequent discussion. Core port at WordPress/wordpress-develop#4204 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All looks good to me except for one small typo. Just left a comment, I think this will be good to land once that's fixed.
@jameskoster - there is a question here about whether this is an urgent enough change to sneak past the soft string freeze which is already past - I am thinking you are best placed to answer this in @ntsekouras absence? |
They are backporting this into the |
Co-authored-by: Andrew Serong <14988353+andrewserong@users.noreply.github.com>
I just cherry-picked this PR to the wp/6.2 branch to get it included in the next release: 861df24 |
@glendaviesnz I'd say it's fairly important. Reason being that template descriptions are given elevated prominence in the Site Editor now, and the current descriptions are not optimised for this: |
The template descriptions in `get_default_block_template_types()` are updated to add more details. Why? These descriptions are now more prominent in 6.2 to provide a better UX experience with more helpful information. References: * [WordPress/gutenberg#48934 Gutenberg PR 48934] Follow-up to [54761], [54104], [54269], [53129], [52331], [52062]. Props ntsekouras, andrewserong, bph, davidbaumwald, greenshady, glendaviesnz, hellofromTonya, jameskoster, mamaduka, peterwilsoncc, sabernhardt, SergeyBiryukov. Fixes #57892. git-svn-id: https://develop.svn.wordpress.org/trunk@55500 602fd350-edb4-49c9-b593-d223f7449a82
The template descriptions in `get_default_block_template_types()` are updated to add more details. Why? These descriptions are now more prominent in 6.2 to provide a better UX experience with more helpful information. References: * [WordPress/gutenberg#48934 Gutenberg PR 48934] Follow-up to [54761], [54104], [54269], [53129], [52331], [52062]. Props ntsekouras, andrewserong, bph, davidbaumwald, greenshady, glendaviesnz, hellofromTonya, jameskoster, mamaduka, peterwilsoncc, sabernhardt, SergeyBiryukov. Fixes #57892. Built from https://develop.svn.wordpress.org/trunk@55500 git-svn-id: http://core.svn.wordpress.org/trunk@55032 1a063a9b-81f0-0310-95a4-ce76da25c4cd
The template descriptions in `get_default_block_template_types()` are updated to add more details. Why? These descriptions are now more prominent in 6.2 to provide a better UX experience with more helpful information. References: * [WordPress/gutenberg#48934 Gutenberg PR 48934] Follow-up to [54761], [54104], [54269], [53129], [52331], [52062]. Props ntsekouras, andrewserong, bph, davidbaumwald, greenshady, glendaviesnz, hellofromTonya, jameskoster, mamaduka, peterwilsoncc, sabernhardt, SergeyBiryukov. Fixes #57892. Built from https://develop.svn.wordpress.org/trunk@55500 git-svn-id: https://core.svn.wordpress.org/trunk@55032 1a063a9b-81f0-0310-95a4-ce76da25c4cd
What?
Related: #48290
I'm not sure if we close the linked issue, as the descriptions have been made a bit shorter, to see if we can include this to
6.2
. The main technical problem with the original suggestions is that they need to have paragraphs/break lines and would involve much more thought and work. After looking at the above, I'm thinking maybe a REST API change in templates might be good, to treatdescription
field liketitle
withraw and rendered
..Notes
Some of the descriptions are still quite long and might not be the best fit with the current UIs. An alternative could be to even update some of them for now, instead of updating all..
Also it's important to note that if this lands in time for RC1 tomorrow, any updates to the strings will not be possible due to the
string freeze
.Testing Instructions
See the new templates description where are shown, like:
templates
list in site editoradd
button to create a new template