Provide a clearer explanation about how "Convert to links" works & include a link to the documentation.

[mrfoxtalbot]

What problem does this address?

When we select a Page List block in the navigation message and click on "Edit", we will be prompted with the following message:

Convert to links

To edit this navigation menu, convert it to single page links. This allows you to add, re-order, remove items, or edit their labels.

Note: if you add new pages to your site, you'll need to add them to your navigation menu.

Screen.Capture.on.2022-09-30.at.16-04-58.mp4

This message does not explain where the current menu comes from and could be clearer in general. It also lacks a link to the docs for more information.

What is your proposed solution?

Let's provide a clearer message that provides more context and includes a link to the support docs. Something long these lines:

Customize your navigation menu

We’ve provided a default list of all your published pages to get going quickly. If you prefer to convert that to an editable menu, click the button below. This will allow you to add, re-order, remove items, or edit their labels.

If you previously created a menu in a classic theme, you’ll have the option to import it later.

Learn more about menu management [link to documentation]

[annezazu]

cc @getdave @scruffian for awareness.

[getdave]

I'd like to find a way of capturing these small "long hanging fruit" type enhancements. Considering adding a section to the Tracking Issue with "Quick wins". Then the team can pick from these as they tackle other more complex problems.

Also these would be great candidates for "Good first issue" for new Nav block contributors.

What do you think?

[mrfoxtalbot]

Thank you @getdave! Do you think we could use [Good First Issue] as a way to track these? Is it better to comment on the tracking issue and have them added to a separate section?

[artemiomorales]

Hi all! New contributor here. I can take this on 🙂

[artemiomorales]

Hi @mrfoxtalbot, I'm looking for clarification on this line: "If you previously created a menu in a classic theme, you’ll have the option to import it later."

Does this mean that users will have the option to import menu in a later release of Gutenberg? If so, I would modify the line to be the following: "If you previously created a menu in a classic theme, you’ll have the option to import it in a later version of the Gutenberg editor."

Let me know what you think!

[mrfoxtalbot]

Hey @artemiomorales .

Does this mean that users will have the option to import menu in a later release of Gutenberg?

No. It means that, once the "Page List" block is converted to an "Editable menu", the user will be able to assign any existing menu (created via a classic theme) to that space, as seen below:

Would this make sense?

[artemiomorales]

@mrfoxtalbot

Yes, that makes sense! I've updated the copy to be the following and created a pull request:

Customize your navigation menu

We’ve provided a default list of your published pages so you can get started quickly. If you’d prefer to edit this menu, click the Convert button below — converting will allow you to add, re-order, and remove items, or edit their labels.

If you previously created a menu in a classic theme, converting will allow you to import it.

Click here to learn more about menu management.

[mrfoxtalbot]

Thank you @artemiomorales!