Incorporated Jai's comments

Author: pabel-rh

modules/customizing-the-appearance/proc-customize-rhdh-sidebar-menuitems.adoc

@@ -24,7 +24,7 @@ dynamicPlugins:
 ----
 <1> `_<plugin_name>_`: Enter the plugin name. This name is the same as the `scalprum.name` key in the `package.json` file.
 <2> `_<menu_item_name>_`: Enter a unique name in the main sidebar navigation for either a standalone menu item or a parent menu item. If this field specifies a plugin menu item, the name of the menu item must match the name using in the corresponding path in `dynamicRoutes`. For example, if `dynamicRoutes` defines `path: /my-plugin`, then `menu_item_name` must be defined as `my-plugin`.
-<3> `icon`: (Optional) Enter the icon name. You can use the following icons:
+<3> `icon`: (Optional) Enter the icon name if you do not want to use the default icon. You can use the following icons:
    * Default icons, such as `home`, `group`, `category`, `extension`, and `school`
    * An SVG icon, such as: `icon: <svg width="20px" height="20px" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg" fill="#ffffff">...</svg>`
    * An HTML image, such as: `icon: https://img.icons8.com/ios-glyphs/20/FFFFFF/shop.png`
@@ -90,10 +90,10 @@ dynamicPlugins:
   <4> `priority`: (Optional) Enter the order of this menu item within its menu level.
   <5> `default._<menu_item_name>_`: Enter the menu item name for which you want to override the default value. Add the `default.` prefix to identify a main menu item.
   <6> `parent`: (Optional) Enter the parent menu item for this item. Required if <menu_item_name> is specified as the child of any menu items.
-  <7> `icon`: (Optional) Enter the menu icon.
+  <7> `icon`: (Optional) Enter the menu icon if you do not want to use the default icon.
   <8> `title`: Enter the menu group title. To hide the title from the sidebar, set the title as an (`" "`) empty string.
 // Update <8> for release 1.6 as this option (currently a  workaround) would be added as a functionality. RHIDP-6333.
-  <9> `to`: (Optional) Enter the path that the menu item navigates to. If not set, it defaults to the home page.
+  <9> `to`: (Optional) Enter the path that the menu item navigates to. If it is not set, it defaults to the home page.
   <10> `priority`: (Optional) Enter the order of this menu item within its menu level.
 
 +
@@ -104,33 +104,25 @@ dynamicPlugins:
 default.main-menu-items:
       menuItems:
         default.catalog:
-          icon: school
-          title: Catalog124
+          icon: category # <1>
+          title: My Catalog 
           priority: 5
-        default.learning-path:
-          title: ''
-        default.list:
-          title: Home
+        default.learning-path: 
+          title: '' # <2> to hide the learning path from default sidebar
+        default.parentlist: # <3>
+          title: Overview 
           icon: bookmarks
-        default.home2:
-          parent: default.list
-          title: home2
-          icon: bookmarks
-          priority: 105
-        default.home1:
-          parent: default.list
-          title: home1
-          icon: bookmarks
-          priority: 205
-        default.home: # <1>
-          parent: default.home2 # <2>
-        default.list2:
-          title: References # <3>
-          icon: bookmarks # <4>
-          to: /create # <5>
+        default.home:
+          parent: default.parentlist # <4>
+        default.references:
+          title: References # <5>
+          icon: school # <6>
+          to: /references # <7>
 ----
-  <1> `default.home`: Specifies the main item name.
-  <2> `parent`: Nests this plugin under the `favorites` parent menu item.
-  <3> `title`: Specifies the name of `default.list2`
-  <4> `icon`: Displays the `bookmarks` icon.
-  <5> `to`: Redirects `default.list2` to the `/create` page.
+  <1> `icon`: Specify if you want to change the icon default menu item for the catalog.
+  <2> `title`: Specify an empty string `" "` to hide the learning path from the default sidebar.
+  <3> `default.parentlist`: Introduces the parent menu item.
+  <4> `parent`: Nests home menu under the `default.parentlist` parent menu item.
+  <5> `title`: Specifies a name for `default.references`
+  <6> `icon`: Displays the `school` icon.
+  <7> `to`: Redirects `default.references` to the `/references` page.