UI Shell: Consistent naming structure for elements

[lesnider]

Summary

• Writers need to know how to refer to UI elements when they write documentation.
• Content guidelines are needed for naming UI elements (main menu, in-page menus, hamburger menu...)

Relevant information

For example, should we call the menu on the left shown here the "main menu" because it leads users throughout the product and the in-page menu that leads users within that page the "page menu"?

IBM Style calls the "main menu" the _navigation tree_. However, "tree" might have a different functional meaning.

Note: IBM Terminology says not to use navigation as a noun

https://carbondesignsystem.com/guidelines/icons/library/ shows the menu icon, but writers don’t know what to call this.

• Do Carbon-compliant products use the hamburger-styled menu or the > expand/< collapse menu approach on their home pages? Shouldn’t we be consistent?

• What should we call this menu? Is it the main menu?

See a detailed discussion in https://ibm-cloud.slack.com/archives/C0M053VPT/p1706712766009609.

Related issue: #3235

[thyhmdo]

Note for Issue sizing: We need to clean up other related issues and link up with this issue for clearer action items.

[mbgower]

I've flagged some of these considerations before, which have ramifications for accessibility, based on the role they are assigned. I'll try to reference some of the issues I've opened.