-
Notifications
You must be signed in to change notification settings - Fork 4k
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
Link to external documentation in Pattern creation snackbar #33481
Comments
For the amount of content shown, it could be a bit disruptive. We should better utilize the block description area for informing and educating users. We can add a link off to learn more within there as well. I'd reserve this guide for something that is multi page or introduces a larger change. |
Like this idea! I've updated the issue title and description. |
Not to open a can of worms but: Would this be even more clear if the name of the block was called something else that more reflected what it does? How about Synced Block? |
Reminds me of adding a declarative way to add support links for any block: #11330 |
It is a good idea to bring in a link to documentation in the Reusable block description area! Kelly. I have heard from a few people who mentioned that Reusable blocks is not a clear name for what is actually a global/synced block. Synced block is a good name for it. Anyhow that is a nice sidetrack to this issue...:) |
Based on discussion taking place in #32464, I wanted to revisit some of the different options available that would help with this issue's goal of providing information about the Reusable block before the point of saving:
^ The Welcome Guide could also link to the external documentation which is a more robust resource. I do like the idea of showing a "Learn more" link in the snack bar after both the block creation and block save — this might be helpful since it's only available temporarily and a lot of time could pass between creating and editing:
But using the block description area would have the advantage of the link being more discoverable. Thoughts? |
A couple of things. I suggest we add the snackbar notification with a Learn more to when the user initially creates a Reusable block. As suggested in this comment: #32464 (comment) The sidetrack... |
Hey @critterverse Channing. I would suggest in the description to only link to the Welcome Guide (getting people used to having it available). Having a Learn more in the snack bar for creating a Reusable block and perhaps also for saving a Reusable block gives people the additional chance to click the link and enter the Welcome Guide area. Using the Welcome Guide as a quick tip area to where they get shorter tips as well as an external link to more information. |
Follow up to #32464
Since the Welcome Guide in the above PR is only accessible from a temporary snack bar shown after the Reusable block is saved, it would be helpful to provide more information about the Reusable block earlier in the editing process.
Making use of the existing block description in the Settings sidebar, it would be great to link out to external documentation about using Reusable blocks: https://wordpress.org/support/article/reusable-blocks/
The text was updated successfully, but these errors were encountered: