complete final sections and cleanup

Signed-off-by: Atif Ali <atali@redhat.com>

Author: aali309

docs/README.md

@@ -48,6 +48,7 @@ The GitOps Console plugin provides search and template capabilities:
 * [ImageUpdaters in the GitOps Console](image-updaters.md)
 * [Rollouts in the GitOps Console](rollouts.md)
 * [Filter, search, and paginate resources](filter-resources.md)
+* [Graphs and topology views](topology.md)
 * [Getting started](getting-started.md)
 * [Troubleshooting](troubleshooting.md)
 

docs/_sidebar.md

@@ -6,6 +6,6 @@
 - [AppProjects in the GitOps Console](appprojects-rbac.md)
 - [ImageUpdaters in the GitOps Console](image-updaters.md)
 - [Rollouts in the GitOps Console](rollouts.md)
+- [Graphs and topology views](topology.md)
 - [Filter, search, and paginate resources](filter-resources.md)
 - [Troubleshooting](troubleshooting.md)
-- [1.22 GA release notes](release-notes-ga.md)

docs/admin-enable-plugin.md

@@ -82,3 +82,8 @@ The GitOps Console plugin is cluster-scoped. A single plugin deployment serves a
 When multiple Argo CD instances exist in different namespaces, their resources appear together in the GitOps pages. Use the namespace selector to limit the view to one namespace or to browse across namespaces.
 
 The **View in Argo CD** action opens the selected application in the Argo CD user interface. This action requires a Route to the Argo CD server.
+
+## Related information
+
+* [Getting started](getting-started.md)
+* [Troubleshooting](troubleshooting.md)

docs/applications.md

@@ -20,12 +20,14 @@ The GitOps Console plugin provides list and details pages for Argo CD Applicatio
 
    ![Project dropdown on the Applications list page](assets/pics/applications-project-selector.png)
 
-### Search and filter
+### Filter and search
 
 Use the list page controls to narrow results:
 
+* **Filter**: Use **Filter** to narrow by:
+  * **Sync Status**: Synced, OutOfSync, Unknown
+  * **Health Status**: Healthy, Progressing, Suspended, Degraded, Missing, Unknown
 * **Search**: Use the search field to match by **Name** or **Label**. Choose the mode from the dropdown next to the field (for example, **Name** with **Search by name...**).
-* **Filter**: Use **Filter** to narrow by **Sync Status** (**Synced**, **OutOfSync**, or **Unknown**) and **Health Status** (**Healthy**, **Progressing**, **Suspended**, **Degraded**, **Missing**, or **Unknown**).
 
 You can combine search and filters. Clear individual chips or use **Clear all filters**. Changing filters, search, or project returns pagination to page 1. See [Filter, search, and paginate resources](filter-resources.md).
 
@@ -36,12 +38,12 @@ The Applications table includes:
 | Column | Description |
 | --- | --- |
 | **Name** | Application name, with a link to the details page. |
-| **Namespace** | Namespace of the Application (shown when browsing more than one namespace). |
+| **Namespace** | Namespace of the Application. |
 | **Sync Status** | Current sync state, with quiet operation state when a sync is in progress or recently finished. |
 | **Health Status** | Overall Application health. |
-| **Revision** | Target revision (or **HEAD**). Multi-source Applications can show an additional revision count. |
-| **Labels** | Application labels (a limited set is shown in the row). |
-| **App Project** | Owning AppProject. |
+| **Revision** | Target revision (or **HEAD**). Multi-source Applications may show additional revision count. |
+| **Labels** | Application labels. |
+| **App Project** | AppProject that this Application belongs to. |
 | **Actions** | Row kebab menu. |
 
 ### Pagination
@@ -54,6 +56,8 @@ Browse results in pages of **10**, **20**, **50**, or **100** items (default **5
 
 2. The console opens the YAML editor with a starter Application template. The template includes placeholders for name, destination, project, repository URL, path, target revision, and sync policy (`automated`, `prune`, `selfHeal`).
 
+   The editor includes a **Schema** side panel that describes Application fields, and a **Download** control to save the YAML.
+
 3. Edit the YAML for your repository and cluster destination, then create the resource.
 
 Application creation uses YAML only. There is no guided form.
@@ -89,6 +93,8 @@ The details page includes the following tabs.
 
 The **Details** tab summarizes identity, status, and sync policy.
 
+![Application Details tab with Actions menu](assets/pics/application-details-tab.png)
+
 **Application summary (left)**
 
 * **Name**, with an optional **Argo CD** link when a Route is available
@@ -117,10 +123,14 @@ Without update permission, the sync policy toggles are disabled.
 
 The **YAML** tab provides a live editor for the Application manifest. Use it to inspect or update the full resource definition.
 
+The editor includes a **Schema** side panel that describes Application fields, and a **Download** control to save the YAML.
+
 ### Sources tab
 
 The **Sources** tab lists repository sources for the Application (single-source and multi-source).
 
+![Application Sources tab with multi-source table](assets/pics/application-sources-tab.png)
+
 Section title: **Application sources**.
 
 The sources table includes:
@@ -152,6 +162,9 @@ The graph and table show health and sync status for the Application’s **immedi
   * **Kind**
   * Search by resource name
 * In list view, the table columns include **Name**, **Namespace**, **Sync Wave**, **Sync Status**, **Health Status**, and row actions.
+
+  ![Application Resources list view](assets/pics/application-resources-list-view.png)
+
 * Row actions can include **View in Argo CD** and **Delete**, depending on the resource and your permissions.
 * The list supports sorting and pagination. See [Filter, search, and paginate resources](filter-resources.md).
 
@@ -162,7 +175,7 @@ The graph and table show health and sync status for the Application’s **immedi
 * Group or ungroup resources of the same kind.
 * Context-menu actions on nodes can include viewing details, editing labels and annotations, deleting resources, editing the Application, and opening **View in Argo CD**.
 
-For more about graphical views, see [Topology view](topology.md).
+For more about graph controls, see [Graphs and topology views](topology.md).
 
 ### Sync Status tab
 
@@ -217,7 +230,7 @@ The **Events** tab shows Kubernetes events for the Application object, using the
 ## Related information
 
 * [Filter, search, and paginate resources](filter-resources.md)
-* [Topology view](topology.md)
+* [Graphs and topology views](topology.md)
 * [ApplicationSets in the GitOps Console](applicationsets.md)
 * [AppProjects in the GitOps Console](appprojects-rbac.md)
 * [Troubleshooting](troubleshooting.md)

docs/applicationsets.md

@@ -1,26 +1,134 @@
 # ApplicationSets in the GitOps Console
 
-The GitOps Console plugin shows key details of Argo CD ApplicationSets. You can view and create ApplicationSets directly from the OpenShift Container Platform web console. A graphical view shows the applications managed by an ApplicationSet and the progressive sync flow from one step to the next.
+The GitOps Console plugin shows list and details pages for Argo CD ApplicationSets in the OpenShift web console. You can search and filter ApplicationSets, create them from a YAML template, review generated Applications, inspect generators, and use the graphical view for owner-reference and progressive sync layouts.
+
+## Prerequisites
+
+* You have access to the OpenShift web console.
+* The GitOps Console plugin is enabled. See [Enable the GitOps Console plugin](admin-enable-plugin.md).
+* You can list ApplicationSets in the selected namespace (or across namespaces, depending on your permissions).
 
 ## List page
 
-The ApplicationSets list page follows the same list patterns as other custom resources:
+1. In the **Administrator** perspective, navigate to **GitOps** → **ApplicationSets**.
 
-* **Table columns**: Standard columns for custom resources
-* **Filtering**: Filter ApplicationSets by health status (Healthy, Error, Unknown)
-* **Pagination**: Browse results in pages of 10, 20, 50, or 100 items (default 50). Search and filters change which rows are included. See [Filter, search, and paginate resources](filter-resources.md).
+2. Optional: Use the **Project** dropdown to limit the list to one project (namespace), or choose all projects.
+
+The ApplicationSets list page includes:
+
+* **Filtering**: Filter ApplicationSets by:
+  * **Health Status**: Healthy, Error, Unknown
+* **Search**: Use the search field to match by **Name** or **Label**. Choose the mode from the dropdown next to the field.
 * **Create action**: Click **Create ApplicationSet** to open the YAML editor with a default ApplicationSet template
+* **Table columns**: **Name**, **Namespace**, **Health Status**, **Generated Apps**, **Generators**, **Labels**, **Created At**, and row actions
+* **Pagination**: Browse results in pages of 10, 20, 50, or 100 items (default 50). Search and filters change which rows are included. See [Filter, search, and paginate resources](filter-resources.md).
 
 > **NOTE**
 >
 > Creation uses the YAML editor. The console does not provide an ApplicationSet form wizard.
 
-## Details page
+### Row actions
+
+From the row kebab, you can:
+
+* **Edit labels**
+* **Edit annotations**
+* **Edit ApplicationSet** (opens the YAML editor)
+* **Delete ApplicationSet**
+
+## ApplicationSet details page
+
+1. From the ApplicationSets list, click an ApplicationSet name.
+
+2. The details page breadcrumb shows **ApplicationSets** → **ApplicationSet details**.
+
+3. Use the page header **Actions** menu for the same edit and delete actions as the list.
+
+The details page includes the following tabs.
+
+### Details tab
+
+The **Details** tab summarizes identity, status, and related counts.
+
+Section title: **ApplicationSet details**.
+
+**Summary (left)**
+
+* **Name**
+* **Namespace**
+* **Labels**, with **Edit**
+* **Annotations**
+* **Created at**
+* **Owner**
+
+**Status and configuration (right)**
+
+* **Status**: Overall health of the ApplicationSet (**Healthy**, **Error**, or **Unknown**)
+* **Generated Apps**: Count of Applications owned by this ApplicationSet, with a link to the **Applications** tab
+* **Generators**: Count of configured generators, with a link to the **Generators** tab
+* **App Project**: AppProject that generated Applications belong to
+* **Repository**: Template source repository URL when the ApplicationSet template uses a single `source` (multi-source templates may not show this field)
+
+**Conditions**
+
+Below the summary, the **Conditions** section shows ApplicationSet status conditions from the controller. Use this table to diagnose generation failures, progressive sync progress, and whether managed Applications are up to date.
+
+The conditions table includes:
+
+| Column | Description |
+| --- | --- |
+| **Type** | Condition type, such as **ErrorOccurred**, **ParametersGenerated**, **ResourcesUpToDate**, or **RolloutProgressing**. |
+| **Status** | **True**, **False**, or **Unknown**. |
+| **Updated** | When the condition last changed. |
+| **Reason** | Short machine-readable cause. |
+| **Message** | Human-readable details. |
+
+Common conditions:
+
+* **ErrorOccurred**: Generation or sync errors for the ApplicationSet.
+* **ParametersGenerated**: Whether generator parameters were produced successfully.
+* **ResourcesUpToDate**: Whether generated Applications match the desired state.
+* **RolloutProgressing**: Progressive sync or rollout is still in progress.
+
+If no conditions are reported, the section shows **No conditions found**.
+
+### YAML tab
+
+The **YAML** tab provides a live editor for the ApplicationSet manifest. Use it to inspect or update the full resource definition.
+
+The editor includes a **Schema** side panel that describes ApplicationSet fields, and a **Download** control to save the YAML.
+
+### Generators tab
+
+The **Generators** tab shows the ApplicationSet generator configuration in a structured view.
+
+Supported generator presentations include **List**, **Cluster**, **git**, **Matrix**, **Merge**, and **Union**. Other generator types use a generic view that shows the configuration as JSON.
+
+If no generators are configured, the tab shows an empty state.
+
+### Applications tab
+
+The **Applications** tab shows Applications generated by this ApplicationSet in list or graph form.
+
+Section title: **ApplicationSet Applications**.
+
+* Switch between **List view** and **Graph view**. The console remembers your preference.
+* Use **Filter** and **Search** (by name or label) to narrow by health and sync status, or by Application name or label.
+* List view uses the same Application table columns, sorting, and pagination as the main Applications list. See [Applications in the GitOps Console](applications.md).
+* Graph view shows the ApplicationSet and its generated Applications:
+  * **Standard layout**: Owner-reference tree when progressive sync is not active
+  * **Progressive Sync Flow View**: Step groups when progressive sync is enabled and step status is available
+
+For graph controls and progressive sync requirements, see [Graphs and topology views](topology.md).
+
+### Events tab
+
+The **Events** tab shows Kubernetes events for the ApplicationSet object, using the standard console event stream for that resource.
 
-The ApplicationSet details page provides the following tabs:
+## Related information
 
-* **Details tab**: Displays status information, generator counts, conditions, links to the Generators and Applications tabs, and shows the number of generated applications of related Applications.
-* **YAML tab**: Provides a live manifest editor for the ApplicationSet resource.
-* **Generators tab**: Provides a structured view of generator configuration, including list, merge, and union generators.
-* **Applications tab**: Displays the list of applications generated by the ApplicationSet with a Graphical View showing visual representation of the generated applications, progressive sync visualization that shows the progressive sync flow from step to step when progressive sync is enabled, a filter widget to filter by health and sync status, and an applications table with the same rich columns, filtering, and pagination as the main Application list page.
-* **Events tab**: Shows Kubernetes events for the ApplicationSet object.
+* [Filter, search, and paginate resources](filter-resources.md)
+* [Graphs and topology views](topology.md)
+* [Applications in the GitOps Console](applications.md)
+* [AppProjects in the GitOps Console](appprojects-rbac.md)
+* [Troubleshooting](troubleshooting.md)