Add Welcome Guide to Styles More Menu

[annezazu]

What problem does this address?

With the introduction of the Welcome Guide for the site editor #32844, it would be great to have a way to trigger it once more.

What is your proposed solution?

Add it as an option here:

[shaunandrews]

Seems like it should go in the top toolbar "..." menu instead, like the Welcome Guide is for the post editor:

We're getting a little carried away with all these different "..." menus. Worth noting the one you suggested is only visible if the Styles sidebar is open.

[annezazu]

AFAIK #32844 handles having it in the usual spot!

[Mamaduka]

I think the "Styles" ellipsis button has a different purpose, similar to Dimensions one. Welcome Guide might be a little out of place there.

@talldan also pointed out a few issues with the current spit Welcome Guide solution - #36172 (comment). I would love to hear more feedback on this one as well 🙇

[mtias]

The main "welcome guide" is for the site editor, not for styles. It seems styles invoke its own when it's opened for the first time, so it makes sense to reinitialize that it's there.

[Mamaduka]

Another question: Do we want only to invoke Styles' welcome guide when a user visits Editor via "Appearance > Styles"?

P.S. I'll do a follow-up PR tomorrow.

[shaunandrews]

The main "welcome guide" is for the site editor, not for styles.

I doubt this separation is obvious or makes sense to anyone outside of the people on this thread. The only way to see the styles is to use the site editor. 🤷

[mtias]

@shaunandrews can you clarify what would open when clicking "welcome guide" in your suggestion? Because there's already a welcome guide attached to the site editor.

[shaunandrews]

Its not clear to me what the distinction is between the two guides. Right now, when I click "Appearance -> Editor" and "Appearance -> Styles" I see the "Welcome to Styles" guide. It seems the only way to trigger the Site Editor guide is to close the styles sidebar. Its really finicky and the logic is not at all obvious. Here's the how I first encountered both guides:

1. I went to the "Appearance -> Styles" and I immediately saw the styles welcome guide, since (for whatever reason) my styles sidebar was open.
2. I kept the sidebar open, and made a few changes.
3. A few minutes later I closed the style sidebar and was immediately shown the site editor welcome guide. This was very confusing, since I wasn't aware what I did to trigger it, and it was so similar to the style guide that I thought it was a bug.

Maybe it should be a single welcome guide that covers both the site editor and styles sidebar? This seems like the best solution considering that the editor welcome guide is a single screen, which mentions styles.

Or, if we're sure we want two, maybe we label them something more descriptive in the menu, and figure out a better way to trigger them when first experiencing the site editor.

[javierarce]

I like the idea of having two entry points for each guide since it's confusing that the same button triggers a different one depending on whether the styles are toggled or not.

Having just one guide could work, but there's a significant imbalance on the content right now: an inner functionality of the site editor (styles) presents more information than the general guide. So if we wanted to merge those guides, we'd probably need to address that.

In any case, those solutions won't scale well as soon as we want to add more slides or guides. So I think at some point, we'll need to rethink how we present this information to the users (in my mind, the ideal solution could be having a general guide organized by sections for each feature).

[Mamaduka]

Do we have the final design/specs for this issue? I can start working on follow-up PR.

[Mamaduka]

Hi, everyone

I just wanted to check in again, if we have the final design for this issue.

Side note: The separate "Styles" entry point was removed recently - #36637.

[shaunandrews]

I just wanted to check in again, if we have the final design for this issue.

I guess the original proposal of adding it to the Styles sidebar "..." menu is still the best solution.

[mtias]

@noisysocks this is a nice to have for 5.9, can be easily punted

[Mamaduka]

@mtias, I've got to push another update for Welcome Guide and will try to include this as well.