Improve copy for managing a block's style variations

[richtabor]

What problem does this address?

The copy in question is: "Manage style variations, saved block appearence presets."

There's a typo (appearence should be appearance), and grammar — but I think we can do better all around. It's not clear where "block appearance presets" came from, but it seems like a fancier way to say "style variations".

This copy is essentially help text for a control that is available within Global Styles — for blocks that have style variations (such as the core/button block). You click the style variation below it to personalize a variation.

Perhaps something like this could work (where "Button" is the block's name:

"Customize variations of the Button block."

Visual

[tomdevisser]

+1, although I wonder if an explanation is needed here at all. We're also not adding explanations to all the options above like "Customize the typography of the Button block.", "Customize the colors of the Button block.", etc. At most I would add a link below the button that says "Learn more about style variations" linking to the docs, like the editor does in multiple places.

[carolynannewells]

Hello! Carolyn from the Publications team here! We saw that this had a copy review ping.

I would suggest a very simple explanation: "You can customize this block's appearance"

[richtabor]

We're also not adding explanations to all the options above like "Customize the typography of the Button block.",

We do for the custom CSS entry point below. I do think we could use some descriptive detail, and perhaps we could add a link in the future — when you can create block style variations as well. Right now those docs would be more technical than applicable to editing the style imo.

I would suggest a very simple explanation: "You can customize this block's appearance"

It's not quite the right intent. You can customize the variations of this block, which can be applied when editing. I was thinking something like: Customize variations of the {NAME} block.

[ndiego]

"Customize variations of the Button block."

Sounds good, but I do want to call out the confusion between a "Block Style" and a "Block Variation". This panel description sort of makes it sound like you are customizing a block variant as opposed to a block style.

Perhaps it should be:

Customize style variations of the {NAME} block.

[richtabor]

Sounds good, but I do want to call out the confusion between a "Block Style" and a "Block Variation". This panel description sort of makes it sound like you are customizing a block variant as opposed to a block style.

True, although "block variations" as a term is not surfaced with the UI — more of a technical facet.

[tomdevisser]

I agree with @ndiego, great addition. I hear you on the term being technical @richtabor, and it's true and should be considered. This however is such a small change that the omitted risk of confusion with devs in my opinion outweighs having a slightly more verbose description.

[richtabor]

This however is such a small change that the omitted risk of confusion with devs in my opinion outweighs having a slightly more verbose description.

Noted. Though I don't think this is dev-centric tooling.

[ndiego]

@richtabor I say let's just go ahead with your suggestion Customize variations of the {NAME} block. String freeze is next week and it would be great to get this updated for 6.2.

[ntsekouras]

Customize variations of the {NAME} block.

For the above I think it's better to do Customize variations of the block: {NAME}, due to i12n issues. We have often encountered this problem.

Having said that, this message is in a place where we have already selected a specific block and IMO it's redundant. No strong opinion though..

[tomdevisser]

Added a PR #48367