Incorporated Heena's comments

Author: pabel-rh

assemblies/assembly-about-software-catalogs.adoc

@@ -3,6 +3,8 @@
 [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 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.
 
 //[Add a Software Catalog screenshot of the latest build]
@@ -12,11 +14,7 @@ The Overview page for a component provides key information such as links to the
 //[Add any Component screenshot of the latest build]
 
 include::modules/software-catalogs/proc-adding-new-components-to-the-rhdh-instance.adoc[leveloffset=+1]
-include::modules/software-catalogs/proc-registering-components-manually.adoc[leveloffset=+2]
-include::modules/software-catalogs/proc-creating-new-components-in-the-rhdh-instance.adoc[leveloffset=+2]
 include::modules/software-catalogs/proc-updating-components-in-the-software-catalog.adoc[leveloffset=+1]
 include::modules/software-catalogs/proc-searching-and-filter-software-catalogs.adoc[leveloffset=+1]
-include::modules/software-catalogs/proc-searching-and-filter-software-catalogs-kind.adoc[leveloffset=+2]
-include::modules/software-catalogs/proc-searching-and-filter-software-catalogs-filter.adoc[leveloffset=+2]
 include::modules/software-catalogs/proc-viewing-software-catalog-yaml.adoc[leveloffset=+1]
 include::modules/software-catalogs/proc-starring-components-in-the-software-catalog.adoc[leveloffset=+1]

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

@@ -6,15 +6,47 @@
 [id="proc-adding-new-components-to-the-rhdh-instance_{context}"]
 = Adding new components to your {product} instance
 
-As a developer, you can add components to your {product-short} instance in any of the following ways:
+You can add components to your {product-short} instance using the following ways:
 
 .Prerequisites
 
 * You have installed the {product} instance.
-* You have the required permissions as a Developer. See link:{authorization-book-url}[{authorization-book-title}].
+* You have the required permissions. See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
-* Registering components manually using the GUI or through your `{my-app-config-file}` with the required permissions.
-* Creating new components through Software Templates.
-* Using the link:{configuring-dynamic-plugins-book-url}#bulk-importing-github-repositories[bulk import plugin] with the required permissions.
+* Register components manually using the GUI or through your `{my-app-config-file}` with the required permissions.
+* Create new components through 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 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 *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].
+. 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.
+
+.Prerequisites
+
+* You have installed 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.

modules/software-catalogs/proc-creating-new-components-in-the-rhdh-instance.adoc

@@ -4,31 +4,27 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="proc-searching-and-filtering-software-catalogs_{context}"]
-= Searching and filtering software catalogs
+= Searching and filtering Software Catalogs
 
 You can search and filter Software Catalogs by its *Kind* or by using the *Filter* field.
 
+== Searching and Filtering Software Catalogs by Kind
+
+To filter a Software Catalog by its *Kind*, complete the following steps:
+
 .Procedure
 
-* In the `{my-app-config-file}` configuration file, modify the `catalog.rules` section to include a rule for templates, and configure the `catalog.locations` section to point to the template that you want to add, as shown in the following example:
+. 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.
 +
-[source,yaml]
-----
-# ...
-catalog:
-  rules:
-    - allow: [Template] # <1>
-  locations:
-    - type: url # <2>
-      target: https://<repository_url>/example-template.yaml # <3>
-# ...
-----
-<1> To allow new templates to be added to the catalog, you must add a `Template` rule.
-<2> If you are importing templates from a repository, such as GitHub or GitLab, use the `url` type.
-<3> Specify the URL for the template.
-
-.Verification
-
-. Click the *Catalog* tab in the navigation panel.
-. In the *Kind* drop-down menu, select *Template*.
-. Confirm that your template is shown in the list of existing templates.
+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
+
+To filter a Software Catalog using the *Filter* field, complete the following steps:
+
+.Procedure
+
+. In your {product} instance, go to *Home > Catalog*.
+. Enter the text you want to use to filter the components.

modules/software-catalogs/proc-registering-components-manually.adoc

@@ -4,12 +4,13 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="proc-starring-components-in-the-software-catalog_{context}"]
-= Starring components in the software catalog
+= Starring components in the Software Catalog
 
 To quickly access the Software Catalogs that you visit regularly, complete the following steps:
 
 .Procedure
 
+. 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.
 

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

@@ -4,17 +4,18 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="proc-updating-components-in-the-software-catalog_{context}"]
-= Updating components in the software catalog
+= Updating components in the Software Catalog in your {product} instance
 
-To update components in the Software Catalog, complete the following steps:
+To update components in the Software Catalog in your {product} instance, complete the following steps:
 
 .Prerequisites
 
 * You have installed the {product} instance.
-* You have the required permissions as a Developer. See link:{authorization-book-url}[{authorization-book-title}].
+* You have the required permissions. See link:{authorization-book-url}[{authorization-book-title}].
 
 .Procedure
 
+. 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.
 +
 This action redirects you to the YAML file on GitHub.

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

@@ -4,17 +4,13 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="proc-viewing-software-catalog-yaml_{context}"]
-= Viewing the Software Catalog YAML file
+= Viewing the Software Catalog YAML file in your {product} instance
 
-To view the Software Catalog YAML file, complete the following step:
-
-.Prerequisites
-
-* You have created a directory or repository that contains at least one template YAML file.
-* If you want to use a template that is stored in a repository such as GitHub or GitLab, you must configure a {product} integration for your provider.
+To view the Software Catalog YAML file in your {product} instance, complete the following steps:
 
 .Procedure
 
-. On the Home page, click *Catalog*.
+. 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.
-	This action redirects you to the YAML file on your version control.
++
+This action redirects you to the YAML file on your version control.