docs: refined ArgoCD docs

Author: onelrian

argocd/README.md

@@ -1,61 +1,24 @@
-# ArgoCD Deployment
+# Argo CD Deployment Guide
 
-This directory contains infrastructure-as-code and configuration for deploying **ArgoCD** to enable GitOps-based continuous delivery for the platform.
-
-ArgoCD provides:
-*   **Declarative GitOps**: Synchronizing cluster state with Git repositories.
-*   **Continuous Deployment**: Automated application updates and rollbacks.
-*   **Drift Detection**: Alerting on manual changes to the cluster configuration.
+Argo CD is a declarative, GitOps continuous delivery tool for Kubernetes. It automates the deployment of applications by continuously monitoring Git repositories and synchronizing the desired application state with the live state in your Kubernetes cluster.
 
 ## Deployment Options
 
-### Automated Deployment
-This component is deployed using Terraform. The configuration is located in the `terraform/` directory.
-
-#### Prerequisites
-*   Terraform >= 1.0
-*   Kubernetes Cluster (GKE)
-*   kubectl configured
-
-#### Quick Start
-1.  Navigate to the directory:
-    ```bash
-    cd terraform
-    ```
-2.  Initialize Terraform:
-    ```bash
-    terraform init
-    ```
-3.  Configure Variables:
-    Copy the template and adjust values:
-    ```bash
-    cp terraform.tfvars.template terraform.tfvars
-    ```
-4.  Apply configuration:
-    ```bash
-    terraform apply
-    ```
-
-## Troubleshooting
-
-### Common Issues
-
-**ArgoCD Server Pod CrashLoopBackOff**
-```bash
-# Check logs for permission/resource errors
-kubectl logs -n argocd -l app.kubernetes.io/name=argocd-server
-```
-
-**Login Failure**
-```bash
-# Retrieve initial admin password
-kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
-```
-
-**"Unknown" Application Status**
-```bash
-# Verify repo accessibility
-kubectl logs -n argocd -l app.kubernetes.io/name=argocd-repo-server
-
-# Fix: Check network policies allowing Git access
-```
+We provide two ways to deploy Argo CD to your Kubernetes cluster:
+
+### 1. Manual Deployment
+
+Deploy Argo CD manually using Helm with customizable values files. This approach gives you full control over the configurations.
+
+**[Manual Deployment Guide](../docs/manual-argocd-deployment.md)**
+
+The manual deployment uses the production-ready values file located at [`argocd/manual/argocd-prod-values.yaml`](manual/argocd-prod-values.yaml),
+
+### 2. Automated Deployment (Terraform)
+
+Deploy Argo CD automatically using Terraform for infrastructure-as-code management
+
+**[Automated Deployment Guide](#)** *(Coming soon)*
+
+The automated deployment is located in the [`argocd/terraform/`](terraform)
+