Incorporated Lindsey's comments

Author: pabel-rh

assemblies/assembly-about-software-catalogs.adoc

@@ -3,13 +3,15 @@
 [id="{context}"]
 = About Software Catalogs
 
-The {product} Software Catalog is a centralized system that gives you visibility into all the software across your ecosystem from services, websites, libraries, data pipelines, and more. You can use it to view ownership details and metadata for each component in one place. By storing metadata in YAML files alongside the code, you allow {product} to process and display this information through a clear, visual interface. With the Software Catalog, you can manage and maintain your software, stay aware of all software available in your ecosystem, and take ownership of your services and tools.
+The {product} Software Catalog is a centralized system that gives you visibility into all the software across your ecosystem, including services, websites, libraries, and data pipelines. You can use it to view ownership details and metadata for each component in one place.
 
 The metadata for the components in your Software Catalog is stored as YAML files that live alongside your code in your version control system. The version control repositories can include one or many metadata files. Software Catalog organizes items as entities, which include Components, Resources, and APIs, and other related types. Each entity includes associated metadata such as its owner, type, and other relevant details.
 
+By storing metadata in YAML files alongside the code, you allow {product} to process and display this information through a clear, visual interface. With the Software Catalog, you can manage and maintain your software, stay aware of all software available in your ecosystem, and take ownership of your services and tools.
+
 //[Add a Software Catalog screenshot of the latest build]
 
-The Overview page for a component provides key information such as links to the source code, documentation, dependencies, and ownership details. You can customize this page with plugins to suit specific needs.
+The *Overview* page for a component provides key information such as links to the source code, documentation, dependencies, and ownership details. You can customize this page with plugins to suit specific needs.
 
 //[Add any Component screenshot of the latest build]
 

modules/software-catalogs/proc-adding-new-components-to-the-rhdh-instance.adoc

@@ -5,48 +5,46 @@
 :_mod-docs-content-type: PROCEDURE
 [id="proc-adding-new-components-to-the-rhdh-instance_{context}"]
 = Adding new components to your {product} instance
- 
-You can add components to your {product-short} instance using the following ways:
 
 .Prerequisites
 
-* You have installed the {product} instance.
+* You have installed and configured the {product} instance.
 * You have the required permissions. See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
-* Register components manually using the GUI or through your `{my-app-config-file}` with the required permissions.
-* Create new components through Software Templates.
+You can add components to your {product-very-short} instance using the following methods:
+
+* Register components manually using the GUI or by using your `{my-app-config-file}` with the required permissions.
+* Create new components by using Software Templates.
 * Use the bulk import plugin with the required permissions. For more information, see link:{configuring-dynamic-plugins-book-url}#bulk-importing-github-repositories[the bulk import plugin].
 
 == Registering components manually in your {product-very-short} instance
 
-To register components in the Software Catalog manually in your {product-very-short} instance, complete the following steps:
-
 .Prerequisites
 
-* You have installed the {product} instance.
+* You have installed and configured the {product} instance.
 * You have the required permissions. See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
+To register components in the Software Catalog manually in your {product-very-short} instance, complete the following steps:
+
 . In your {product} instance, go to *Home > Catalog*.
-. On the Catalog page, click *Register Existing Component*.
-. On the Register an existing component page, enter the full URL to the YAML file you wish to register. For example: link:https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/components/artist-lookup-component.yaml[Artist lookup component].
+. On the *Catalog* page, click *Register Existing Component*.
+. On the *Register an existing component* page, enter the full URL to the YAML file you want to register. For example: link:https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/components/artist-lookup-component.yaml[Artist lookup component].
 . Complete the wizard instructions.
 
 == Creating new components in your {product} instance
 
-You can create new components in the Software Catalog in your {product-very-short} instance.
+You can create new components in the Software Catalog in your {product-very-short} instance. {product} automatically registers all components that developers or platform engineers create using Templates in the Software Catalog.
 
 .Prerequisites
 
-* You have installed the {product} instance.
+* You have installed and configured the {product} instance.
 * You have the required permissions See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
 . In your {product} instance, go to *Home > Catalog*.
-* On the Catalog page, click *Self-service*.
-
-{product} automatically registers all components that developers or platform engineers create using Templates in the Software Catalog.
+* On the *Catalog* page, click *Self-service*.

modules/software-catalogs/proc-searching-and-filter-software-catalogs.adoc

@@ -15,10 +15,10 @@ To filter a Software Catalog by its *Kind*, complete the following steps:
 .Procedure
 
 . In your {product} instance, go to *Home > Catalog*.
-. On the Catalog page, click the *Kind* drop-down list.
-. Select the type of Kind you want to filter.
+. On the *Catalog* page, click the *Kind* drop-down list.
+. Select the type of *Kind* you want to filter.
 +
-The available filter dropdowns vary based on the Kind you select, displaying options relevant to that specific entity type.
+The available filter dropdowns vary based on the *Kind* you select, displaying options relevant to that specific entity type.
 
 == Searching and Filtering Software Catalogs using the Filter field
 
@@ -27,4 +27,4 @@ To filter a Software Catalog using the *Filter* field, complete the following st
 .Procedure
 
 . In your {product} instance, go to *Home > Catalog*.
-. Enter the text you want to use to filter the components.
+. In the *Search* box, enter the text you want to use to filter the components.

modules/software-catalogs/proc-starring-components-in-the-software-catalog.adoc

@@ -6,13 +6,16 @@
 [id="proc-starring-components-in-the-software-catalog_{context}"]
 = Starring components in the Software Catalog
 
-To quickly access the Software Catalogs that you visit regularly, complete the following steps:
+
+You can use the *Add to favorites* icon to add the software catalogs that you visit regularly to the *Starred* category.
 
 .Procedure
 
+To quickly access the Software Catalogs that you visit regularly, complete the following steps:
+
 . In your {product} instance, go to *Home > Catalog*.
-. On the Home page, click *Catalog*.
-. On the Red Hat Catalog page, on the Software Catalog that you want to star, under *Actions*, select the *Add to favorites* icon.
+. On the *Home* page, click *Catalog*.
+. On the *Catalog* page, on the Software Catalog that you want to star, under *Actions*, select the *Add to favorites* icon.
 
 .Verification
 

modules/software-catalogs/proc-updating-components-in-the-software-catalog.adoc

@@ -6,19 +6,29 @@
 [id="proc-updating-components-in-the-software-catalog_{context}"]
 = Updating components in the Software Catalog in your {product} instance
 
-To update components in the Software Catalog in your {product} instance, complete the following steps:
+You can update components in the Software Catalog in your {product} instance.
 
 .Prerequisites
 
-* You have installed the {product} instance.
+* You have installed and configured the {product} instance.
 * You have the required permissions. See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
+To update components in the Software Catalog in your {product} instance, complete the following steps:
+
 . In your {product} instance, go to *Home > Catalog*.
 . On *Home page > Catalog*, on the entity that you want to edit, under *Actions*, select the *Edit* icon.
+
 +
+[NOTE]
+====
 This action redirects you to the YAML file on GitHub.
+====
 . On your version control system, update your YAML file.
+
 +
-Once you merge your changes, the updated metadata in the Software Catalog appears after some time.
+[NOTE]
+====
+After you merge your changes, the updated metadata in the Software Catalog appears after some time.
+====

modules/software-catalogs/proc-viewing-software-catalog-yaml.adoc

@@ -6,11 +6,17 @@
 [id="proc-viewing-software-catalog-yaml_{context}"]
 = Viewing the Software Catalog YAML file in your {product} instance
 
-To view the Software Catalog YAML file in your {product} instance, complete the following steps:
+You can view the Software Catalog YAML file in your {product} instance. The YAML file displays the metadata for the components in your Software Catalog. 
 
 .Procedure
 
+To view the Software Catalog YAML file in your {product} instance, complete the following steps:
+
 . In your {product} instance, go to *Home > Catalog*.
-. On the Red Hat Catalog page, on the Software Catalog that you want to star, under *Actions*, select the *View* icon.
+. On the *Catalog* page, on the Software Catalog that you want to star, under *Actions*, select the *View* icon.
+
 +
-This action redirects you to the YAML file on your version control.
+[NOTE]
+====
+These steps redirect you to the YAML file on your version control.
+====