Incorporated tech comments

Author: pabel-rh

modules/customizing-templates/proc-versioning-software-templates.adoc

@@ -14,10 +14,11 @@ As a platform administrator, you can version Software Templates by using the exi
 
 .Procedure
 
-To add versioning to a Software Template yaml file, modify the Software Template that you want to update and do either of the following steps:
-
-* Include the `backstage.io/template-version` annotation in your template. When this annotation is present in your template, it will be automatically used to annotate your catalog entity.
+To add versioning to a Software Template yaml file, complete the following steps:
 
+. Modify the Software Template that you want to update.
+. Complete one or both of the following tasks:
+* Include the `backstage.io/template-version` annotation in your template. When this annotation is present in your template, it is automatically used to annotate your catalog entity and a default version value is displayed.
 * Pass the `backstage.io/template-version` annotation as input to the action. This method takes precedence over the annotation in the template itself. It allows the user running the template to specify the version they wish to generate.
 
 +
@@ -34,7 +35,10 @@ To add versioning to a Software Template yaml file, modify the Software Template
 ----
 
 .Verification
-
-. link:{configuring-book-url}#ref-creating-templates_configuring-templates[Create a component using the Software Template] that is updated for versioning.
-. In the *Catalog* page, select the newly created Software Template and click *VIEW SOURCE*.
-. In your GitHub page, go to your `catalog-info.yaml` file and you are able to see `backstage.io/template-version`.
+. link:{configuring-book-url}#ref-creating-templates_configuring-templates[Create a catalog component using the updated Software Template]. This step creates a new component in Backstage and optionally, pushes files to an external repository (For example, GitHub, GitLab).
+. Check the component in the Catalog UI.
+.. On the *Catalog* page, locate the newly created catalog component.
+.. Verify that the `backstage.io/template-version` annotation is present in the entity. You can use *INSPECT ENTITY* and select *YAML Raw* or *JSON Raw* view to find the annotation in the component definition.
+. Only if you have published the catalog component: Check the component file in the repository.
+.. If *VIEW SOURCE* is present in your UI: Click *VIEW SOURCE* to open the stored component file in the repository.
+.. Locate the file manually and verify that the `backstage.io/template-version` annotation is present.