Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Compile a list of possible block-specific tips #16595
Whether we end up placing them inside of block UI/placeholders (#16315), in the block library (#16592), or in the sidebar (#16594), let's use this thread to compile a list of possible "Tips" for the current set of Core blocks. A few examples to get us started:
Could this also extend to if someone is using a block and another could be good to use with it? Sort of like "oh hey you added 3 images, what about the gallery block?". Similarly, what about recommending blocks that follow patterns. Maybe if people use quote block they likely use another type of block (we'd need data).
All good suggestions. I definitely think suggesting other blocks is a good idea.
Here are a few other tips gathered from re-watching the latest round of user testing videos on make.wordpress.org/test:
*We should include the icon in this message.
Here's another set of these, created by just going through Gutenberg's "Common Blocks":
As I was running through these, I ran into a nomenclature issue when it came to the "block sidebar". On small screens, that isn't a sidebar at all, and calling it that also doesn't work well with screen readers either.
Depending on where these show up, @sarahmonster suggested we might avoid referring to the location entirely. For instance, something like:
... could instead be something like:
Once users know where block settings live, they'll (hopefully!) know where to look for that sort of setting anyway — these block-specific tips may not be the best place to teach folks where things live.
I'm going to keep going through more blocks to grow this list later, but I'd love for some further thoughts on how/if we should refer to locations like the sidebar + toolbar in these tips.
More tips for the Formatting, Layout Elements, Widget, and Embed blocks.
I tried to include at least tone for each block (even when the functionality was relatively limited, as in the case of the Spacer block.
I think this covers every one of the core blocks. Anything missing? Id love some feedback on these, as well as what other tips we should provide.
referenced this issue
Aug 6, 2019
Great start, @kjellr. I think we should start with just a handful to make sure they are adding considerable value. In that sense, I think these should be about things that are not obvious. (The indenting on a list is a good one.)
For example, if you are adding an image we could tell the user how to get a "side by side" display of two images by converting it into a gallery.
Things that just explain the common tools (toolbar items, block inspector) seem less relevant as we should always be explaining these in the context of the tools themselves.
Here's a more refined list:
Or, if we really want to trim down to just a handful:
If these sound about right, we can see about having the copy reviewed.