Are we going to use the term menu or navigation? Menu doesn't sort of bind us to the classic menus screen...

Yeah, I don't know! This question was also asked in the tracking issue. The button is currently 'New menu' in the editor, so I think as longs as the docs match the UI it's ok.

If/when the UI changes we can update the docs to match.

I personally can't see a switch entirely to 'Navigation' because 'New navigation' doesn't sound right. That might be because navigation is an uncountable noun, so it can't represent a tangible item.

Oh, I see now you were referring to the title. Good point, I changed it.

It's a nitpick, but I don't think 'you' is correct because different users could've created the menus, not just the reader. 😄

I'm a bit hesitant about saying 'classic' right now. Widget docs use the term 'previous', so I think it's good to stay consistent. This might change if we decide to use the term 'classic' in the UI or as a plugin.

The sentence is a bit awkward, but I don't know, I think I'll leave it for now.

I've gone half and half on this. I don't like leaving out that the editor 'provides options', because otherwise the 'by copying an existing menu' part makes it sound like the user has to find the menu, copy it, and then paste it.

Lets avoid using backticks for words because this formats it like code, which I don't think is relevant for user docs.

I only used them for the + button because it makes it look more like the icon, but I expect there will be images in the final docs.

I don't think 'Once the item is inserted into the editor' is needed because the line above tells them to insert it and it happens immediately.

I have changed this by splitting out the instructions for a custom link, which I think makes it clearer.

The goal is to add a submenu. At this point the "block" is an implementation detail.

Yeah, I initially started with that, but added 'block' because this heading was very similar to 'How to create a menu' 🤔

Maybe that's ok, I'll change it back.

I changed this and the above heading to 'How to insert a link' and 'How to insert a submenu', which I think is better all round 👍