Please stop using: 'Invoke the command several ways'

[Roy_043]

I keep seeing pages with this text:

Invoke the command several ways:

This sentence is not correct English. Please stop using it.

Use:
There are several ways to invoke the command:

Or:
To invoke the command do one of the following:

Don't forget to update your templates as well!

[hmk]

What I often see is that 2 usages are described:
- press the button
- select from top-level menu

Since the menu-selection is already described prominently in the {{GuiCommand}} template, I feel there is not need to repeat this again. It also hampers the reading flow a bit, I feel. Plus, both descriptions need to be kept in sync.

How do others feel about this?

[Roy_043]

I would not be in favor of that. You have to consider that not all commands can be accessed via a menu and a toolbar. Some can only be accessed via a menu (Mesh_RemeshGmsh) and others can be accessed in 4 or 5 different ways (Std_ToggleVisibility). Leaving out the menu option would then be a bit strange IMO.

[hmk]

I would not be in favor of that. You have to consider that not all commands can be accessed via a menu and a toolbar. Some can only be accessed via a menu (Mesh_RemeshGmsh) and others can be accessed in 4 or 5 different ways (Std_ToggleVisibility). Leaving out the menu option would then be a bit strange IMO.

I see, so this page should actually ADD the menu-selection: https://wiki.freecadweb.org/Draft_Annot ... itor#Usage

[Roy_043]

Yes.
If you are going to implement this for the Draft WB, please note that the layout of the Draft menus has changed. The single Draft menu does not exist anymore in V0.19. Instead there are 4 Draft menus. F.e. Draft → Move should become Modification → Move. And if you add the menu option to the usage section it would make sense to also put the keyboard shortcut option on a separate line.

[hmk]

Yes.
If you are going to implement this for the Draft WB, please note that the layout of the Draft menus has changed. The single Draft menu does not exist anymore in V0.19. Instead there are 4 Draft menus. F.e. Draft → Move should become Modification → Move. And if you add the menu option to the usage section it would make sense to also put the keyboard shortcut option on a separate line.

Thanks for this valuable information. I guess I stay away from this for now. Since I just started making edits, I want to increase the impact of my changes gradually. So, especially no "mass changes" for me.

[Roy_043]

I completely understand that, the wiki can be a bit daunting. I still have to get an overview of many wiki related things myself.