Apply peer suggestions

Author: GitHub Actions

assemblies/assembly-configuring-the-global-header.adoc

@@ -4,13 +4,13 @@
 = Configuring the global header in {product}
 
 As an administrator, you can configure the {product} global header to create a consistent and flexible navigation bar across your {product-short} instance.
-By default, the {product} global header includes the following components:
+By default, the {product-short} global header includes the following components:
 
 * *Create* button provides quick access to a variety of templates, enabling users to efficiently set up services, backend and front-end plugins within {product-short}
 * *Support* button that can link an internal or external support page
 * *Notifications* button displays alerts and updates from plugins and external services
-* *Search* input field allows users to find services, components, documentation, and other resources within {product}
-* *Plugin extension capabilities* provide a pre-installed and enabled catalog of available plugins in {product}
+* *Search* input field allows users to find services, components, documentation, and other resources within {product-short}
+* *Plugin extension capabilities* provide a preinstalled and enabled catalog of available plugins in {product-short}
 * *User profile* drop-down menu provides access to profile settings, appearance customization, {product-short} metadata, and a logout button
 
 include::modules/configuring-the-global-header/proc-customize-rhdh-global-header.adoc[leveloffset=+1]

modules/configuring-the-global-header/proc-customize-rhdh-global-header.adoc

@@ -6,12 +6,12 @@ You can use dynamic plugins to extend the global header with additional buttons
 To extend the functionality of the default global header, include any the following attributes in your global header entry:
 
 `mountPoint`::
-Specifies the location of the header. Use `application/header` to specify it as a global header.
+Specifies the location of the header. Use `application/header` to specify it as a global header. You can configure several global headers at different positions by adding entries to the `mountPoints` field.
 
 `importName`::
 Specifies the component exported by the global header plugin.
 +
-Below is a list of available header components that you can configure using the `config` field:
+The following header components are possible values for the `config` field in the `dynamic-plugins.default.yaml` file:
 
 - **`SearchComponent`**: Adds a search bar (enabled by default).
 - **`Spacer`**: Adds spacing in the header to position buttons at the end. Useful when you disable `SearchComponent`.
@@ -29,11 +29,6 @@ Below is a list of available header components that you can configure using the
 `config.position`::
 Specifies the position of the header. Supported values are `above-main-content` and `above-sidebar`.
 
-[NOTE]
-====
-You can configure several global headers at different positions by adding entries to the `mountPoints` field.
-====
-
 .Prerequisites
 * You have configured the support URL in the `{my-app-config-file}` file.
 * You have installed the notifications plugin.
@@ -44,15 +39,15 @@ You can configure several global headers at different positions by adding entrie
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
-- package: `_<npm_or_oci_package-reference>_`
+- package: _<npm_or_oci_package-reference>_
   disabled: false
   pluginConfig:
     dynamicPlugins:
       frontend:
         <package_name>:
           mountPoints:
             - mountPoint: application/header
-              importName: `_<Header_component_name>_`
+              importName: _<Header_component_name>_
               config:
                 position: above-main-content
 ----

modules/configuring-the-global-header/proc-mount-points.adoc

@@ -8,7 +8,7 @@ Controls the header position. Use `config.position` to set placement as either `
 
 global.header/component::
 Configures header components. Use `config.priority` to set the order of components, and pass properties (including CSS styles) via `config.props`.
-
++
 .Example adding a *Self-service* button
 [source,yaml,subs="attributes,quotes"]
 ----
@@ -21,7 +21,7 @@ Configures header components. Use `config.priority` to set the order of componen
       icon: add
       to: create
 ----
-
++
 .Example adding a spacer element
 [source,yaml]
 ----
@@ -32,7 +32,7 @@ Configures header components. Use `config.priority` to set the order of componen
     props:
       growFactor: 0
 ----
-
++
 .Example adding a divider element
 [source,yaml]
 ----
@@ -45,7 +45,7 @@ mountPoints:
 
 global.header/profile::
 Configures the profile dropdown list when the `ProfileDropdown` component is enabled.
-
++
 .Example adding a settings link to the profile dropdown
 [source,yaml]
 ----
@@ -61,7 +61,7 @@ Configures the profile dropdown list when the `ProfileDropdown` component is ena
 
 global.header/create::
 Configures the create dropdown list when the `CreateDropdown` component is enabled.
-
++
 .Example adding a section for registering a component
 [source,yaml]
 ----