SUSE AI: added recommended Lifecycle Manager install method (#38)

* SUSE AI: added recommended Lifecycle Manager install method

* Apply suggestions from code review

Co-authored-by: Daria Vladykina <daria.vladykina@suse.com>

Author: tbazant

tasks/ai-lifecycle-manager-installing-rancher-ui.adoc

@@ -7,7 +7,7 @@ ifdef::override-title[]
 :page-revdate: {revdate}
 endif::[]
 ifndef::override-title[]
-= Installing {sailifecyclemanager} using {ranchera} UI
+= Installing {sailifecyclemanager} extension using {ranchera} UI
 endif::[]
 // overridden abstract?
 ifdef::override-abstract[]
@@ -24,18 +24,53 @@ endif::[]
 
 include::../snippets/ai-rancher-admin-requirement.adoc[]
 
+You can install the extension either from a GitHub branch or from a GitHub registry (OCI container).
+
+[#ai-lifecycle-manager-extension-github-branch]
+== Installation using a GitHub branch (the recommended method)
+
+The {sailifecyclemanager} extension is primarily distributed via a GitHub branch (gh-pages).
+This is the default and recommended installation method because it *enables seamless, in-place upgrades* directly from the {ranchera} UI.
+
+. In {ranchera}, navigate to menu:Extensions[Manage Repositories]
+. Click btn:[Create], enter a name for the repository and select `Git repository containing Helm chart or cluster template definitions`.
+. Enter `https://github.com/SUSE/suse-ai-lifecycle-manager` as the Git repository URL and `gh-pages` as the Git branch.
+Confirm with btn:[Create].
+. Wait until the {sailifecyclemanager} repository has the Active state.
+. Go back to the `Extensions` page and install {sailifecyclemanager}.
+. Reload {ranchera} Dashboard by reloading the Web browser window to ensure the extension is loaded in the UI.
+. The "SUSE AI Lifecycle Manager" logo will now appear on the left panel of the {ranchera} Dashboard.
+
+[NOTE]
+.Points to consider
+====
+* Using the GitHub branch method allows seamless updates without reinstallation.
+* If the extension does not appear after installation, try clearing the browser cache and reloading again.
+====
+
+[#ai-lifecycle-manager-extension-github-registry]
+== Installation using a GitHub registry (an alternative method)
+
+This method is provided for environments where Git-based repositories cannot be used.
+It does not support in-place upgrades.
+
 . In {ranchera}, navigate to menu:Extensions[Manage Extensions Catalog]
 . Import the extension catalog from GitHub.
-  Enter `ghcr.io/suse/suse-ai-lifecycle-manager:<VERSION>` in the btn:[Catalog Image Reference] input field.
-  Replace `<VERSION>` with a tag published in the GitHub Container Registry.
-  Confirm with btn:[Load].
+Enter `ghcr.io/suse/suse-ai-lifecycle-manager:<VERSION>` in the btn:[Catalog Image Reference] input field.
+Replace `<VERSION>` with a tag published in the GitHub Container Registry.
+Confirm with btn:[Load].
 . From the `Manage Repositories` page, verify if the {sailifecyclemanager} repository has the `Active` state.
-  If not, refresh the connection.
+If not, refresh the connection.
 . Go back to the `Extensions` page and start the installation by clicking btn:[{sailifecyclemanager}].
 . Reload {ranchera} Dashboard by reloading the Web browser window to ensure the extension is loaded in the UI.
+The "`SUSE AI Lifecycle Manager`" logo will now appear on the left panel of the {ranchera} Dashboard.
 
 [NOTE]
+.Points to consider
 ====
-Newly published catalogs are not always available immediately.
+* To upgrade to a newer version of the extension, you must *reinstall the container* with the updated version tag.
+In-place upgrades are not supported with this method.
+* Replace `<VERSION>` with a valid tag published in the GitHub Container Registry.
+* Newly published catalogs are not always available immediately.
 If the catalog does not show up after publishing, navigate to menu:Extensions[Manage Repositories] and manually refresh the repository to force a re-sync.
 ====