Adding manually

Author: pabel-rh

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

@@ -21,20 +21,48 @@ 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.
+
 .Prerequisites
 
 * 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} navigation menu, click *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 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].
+To add a new component to your {product-very-short} instance, complete the following steps:
+
+. In the root directory of your software project, create a file named `catalog-info.yaml` file.
++
+--
+.`catalog-info.yaml` file example
+[source,yaml]
+----
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+    name: _<your_software_component>_
+    description: _<software_component_brief_description>_
+    tags:
+         - example
+         - service
+    annotations:
+         github.com/project-slug: my-org/my-repo
+spec:
+    type: service
+    owner: team-name
+    lifecycle: production
+----
+. 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*.
+. On the *Self-service* page, click *Register Existing Component*.
+. On the *Register an existing component* page, enter the full URL of the `catalog-info.yaml` file in your repository. 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.
 
+.Verification
+
+* Your software component is listed in the Software Catalog. You can view its details and ensure all the metadata is accurate.
+
 == Creating new components in your {product} 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.