Incorporated Ben's comments

Author: pabel-rh

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

@@ -21,7 +21,7 @@ You can add components to your {product-very-short} instance using the following
 
 == Registering components manually in your {product-very-short} instance
 
-You can manually register components in your {product-very-short} instance by creating a `catalog-info.yaml` file and adding it with {product}. The `catalog-info.yaml` file is a metadata for your software component.
+To manually register components in your {product-very-short} instance, create a `catalog-info.yaml` file and register it with your {product} instance. The `catalog-info.yaml` file contains the metadata you wish to register for your software component.
 
 .Prerequisites
 
@@ -34,7 +34,6 @@ To add a new component to your {product-very-short} instance, complete the follo
 
 . In the root directory of your software project, create a file named `catalog-info.yaml` file.
 +
---
 .`catalog-info.yaml` file example
 [source,yaml]
 ----
@@ -47,11 +46,11 @@ metadata:
          - example
          - service
     annotations:
-         github.com/project-slug: my-org/my-repo
+         github.com/project-slug: _<repo_link_of_your_component_to_register>_
 spec:
-    type: service
-    owner: team-name
-    lifecycle: production
+    type: _<your_service>_
+    owner: _<your_team_name>_
+    lifecycle: _<your_lifecycle>_
 ----
 . Commit and the `catalog-info.yaml` file to the root of your project source code repository.
 . In your {product} navigation menu, go to *Catalog* > *Self-service*.