Incorporated Lindsey's comments

Author: pabel-rh

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

@@ -45,7 +45,7 @@ dynamicsPlugins:
 
 .Procedure
 
-. To configure a dynamic plugin menu item, add a `menuItems` section for your _<plugin_name>_ plugin to your `{my-app-config-file}` file:
+. To configure a dynamic plugin menu item, update the `menuItems` section of your _<plugin_name>_ plugin to your `{my-app-config-file}` file. For example:
 +
 [source,yaml]
 ----
@@ -61,8 +61,9 @@ 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 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`
+<3> `icon`: (Optional) Enter the icon name. You can use any of the following icons:
+   * Default icons, such as `home`, `group`, `category`, `extension`, and `school`. To use default icons, set the icon as an (`" "`) empty string.
+   * A custom icon, where _<my_icon>_ specifies the name of your custom icon
    * 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`
 <4> `title`: (Optional) Enter the menu item title. Omit it when the title is already specified in the `dynamicRoutes` configuration under `menuItem.text`. To hide the title from the sidebar, set the title as an (`" "`) empty string.
@@ -127,7 +128,7 @@ 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 if you do not want to use the default icon.
+<7> `icon`: (Optional) Enter the menu icon. To use the default icon, set the icon as an (`" "`) empty string.
 <8> `title`: (Optional) Enter the menu group title. Only required for adding a new custom main menu item. To hide a default main menu item 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 it is not set, it defaults to the home page.
@@ -155,8 +156,8 @@ default.main-menu-items:
           icon: school # <6>
           to: /references # <7>
 ----
-<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.
+<1> `icon`: Specifies if you want to change the icon default menu item for the catalog.
+<2> `title`: Specifies 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`

modules/customizing-the-home-page/proc-defining-the-layout-of-the-product-home-page.adoc

@@ -73,7 +73,7 @@ dynamicPlugins:
 ----
 However, you can see a second card below this card by default.
 
-. Show the cards in three columns by defining the `x` parameter as shown in the following example:
+* Show the cards in three columns by defining the `x` parameter as shown in the following example:
 
 [source,yaml]
 ----