Add gitops site

[tossmilestone]

Summary by CodeRabbit

• Documentation
  • Introduced an “About Alauda Container Platform GitOps” page with a concise GitOps overview.
  • Rebranded GitOps section titles to “Alauda Container Platform GitOps.”
  • Added a new GitOps documentation site entry (v4.0) to navigation.
  • Removed legacy GitOps pages covering concepts, how-tos, installation, upgrades, troubleshooting, observability, and Argo CD guidance to streamline content.

[coderabbitai]

Walkthrough

Large-scale documentation restructuring: numerous GitOps docs under concept, functions, how_to, install, upgrade, observability, and troubleshooting were deleted. A new overview page was added, the GitOps index title was updated, and a new site entry was added to sites.yaml.

Changes

Cohort / File(s)	Summary
Site registry sites.yaml	Added new site entry “gitops” with displayName (en/zh), base /gitops, version "4.0", and repo URL.
GitOps index branding docs/en/gitops/index.mdx	Updated i18n titles and H1 to “Alauda Container Platform GitOps”.
New overview page docs/en/gitops/gitops.mdx	Added GitOps overview page with brief description and ExternalSite reference.
Architecture & Troubleshooting removals docs/en/gitops/architecture.mdx, docs/en/gitops/argocd_troubleshooting.mdx	Removed architecture page and Argo CD troubleshooting guide.
Concepts: Alauda concept info docs/en/gitops/concept/alauda_gitops_concept_info/*, docs/en/gitops/concept/gitops_concept_infro.mdx, docs/en/gitops/concept/index.mdx	Deleted Alauda GitOps concept index and pages (overview, argocd concept, status).
Concepts: Argo CD concept info docs/en/gitops/concept/argocd_concept_info/*	Deleted Argo CD concept index and pages (Application, ApplicationSet, Health, Sync, Tool and its variants).
Functions: Create Application docs/en/gitops/functions/create_argocd_application/*, docs/en/gitops/functions/index.mdx	Removed UI/CLI/YAML guides for creating Applications/ApplicationSets and functions index.
Observability docs/en/gitops/functions/argocd_observability/*	Removed Argo CD component monitoring and GitOps application alert/logs/events docs, plus index.
How To docs/en/gitops/how_to/*	Deleted repository integration, access info, creating app via Argo CD dashboard, and how-to index.
Install docs/en/gitops/install_gitops/*	Removed install index and guides for installing/upgrading Argo CD operator and GitOps plugin.
Upgrade docs/en/gitops/upgrade/*	Removed upgrade index and GitOps plugin upgrade guide.
Intro docs/en/gitops/intro.mdx	Deleted GitOps introduction page.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• add keda docs #29 — Edits several GitOps docs that are deleted here; direct overlap on install/how_to pages.
• Cherrypick from 4.1 to master #51 — Adds gitops/upgrade files that this PR deletes; direct conflict on same paths.
• Add doc for upgrade argocd operator  #189 — Adds upgrade_argocd_operator.mdx which is removed here; direct file-level conflict.

Suggested reviewers

• youyongsong
• chinameok

Poem

Thump-thump goes my doc-clean sweep,
Old trails pruned, new paths we keep.
A carrot of clarity, crisp and bright,
GitOps reborn in streamlined light.
Ears up, paws down—sites.yaml hops—
New burrow mapped for GitOps stops. 🥕🐇

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	The title "Add gitops site" succinctly and accurately reflects the primary change in the changeset — adding a new gitops site entry (sites.yaml) and associated GitOps docs updates; it is directly related to the main change and not misleading. It is concise, clear, and free of noise or unnecessary file lists. A reviewer glancing at history can understand the PR’s primary intent from this title.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/add-gitops-site

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (2)

docs/en/gitops/index.mdx (1)

9-11: Consider adding a direct CTA to the external GitOps docs.

Optional: place under the H1 so readers can jump out immediately.

Apply:

 # Alauda Container Platform GitOps

+<ExternalSite name="gitops" />
+
 <Overview />

docs/en/gitops/gitops.mdx (1)

2-6: Add frontmatter for nav/SEO consistency.

This page lacks frontmatter (title/i18n/weight). Adding it keeps it consistent with other pages and stable in the sidebar.

+---
+i18n:
+  title:
+    en: About Alauda Container Platform GitOps
+    zh: 关于 Alauda Container Platform GitOps
+weight: 60
+---
 
 # About Alauda Container Platform GitOps

Also consider breaking the long paragraph into bullets for scanability.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2e479c1 and 0bfc946.

⛔ Files ignored due to path filters (7)

• docs/en/gitops/assets/architecture_alauda_gitops.png is excluded by !**/*.png
• docs/en/gitops/assets/architecture_gitops.jpg is excluded by !**/*.jpg
• docs/en/gitops/assets/argo_cd_service_nodeport.png is excluded by !**/*.png
• docs/en/gitops/assets/new_app_button.png is excluded by !**/*.png
• docs/en/gitops/assets/new_app_button_info.png is excluded by !**/*.png
• docs/en/gitops/assets/new_app_button_repo.png is excluded by !**/*.png
• docs/en/gitops/assets/new_app_button_source.png is excluded by !**/*.png

📒 Files selected for processing (39)

• docs/en/gitops/architecture.mdx (0 hunks)
• docs/en/gitops/argocd_troubleshooting.mdx (0 hunks)
• docs/en/gitops/concept/alauda_gitops_concept_info/alauda_gitops_concept_argocd.mdx (0 hunks)
• docs/en/gitops/concept/alauda_gitops_concept_info/alauda_gitops_concept_argocd_status.mdx (0 hunks)
• docs/en/gitops/concept/alauda_gitops_concept_info/index.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_application.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_applicationset.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_health.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_sync.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_directory.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_helm.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_kustomize.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/gitops_concept_argocd.mdx (0 hunks)
• docs/en/gitops/concept/argocd_concept_info/index.mdx (0 hunks)
• docs/en/gitops/concept/gitops_concept_infro.mdx (0 hunks)
• docs/en/gitops/concept/index.mdx (0 hunks)
• docs/en/gitops/functions/argocd_observability/argocd_operator_observability.mdx (0 hunks)
• docs/en/gitops/functions/argocd_observability/gitops_application_alert.mdx (0 hunks)
• docs/en/gitops/functions/argocd_observability/index.mdx (0 hunks)
• docs/en/gitops/functions/create_argocd_application/create_application_via_platform.mdx (0 hunks)
• docs/en/gitops/functions/create_argocd_application/create_applicationset_via_platform.mdx (0 hunks)
• docs/en/gitops/functions/create_argocd_application/index.mdx (0 hunks)
• docs/en/gitops/functions/index.mdx (0 hunks)
• docs/en/gitops/gitops.mdx (1 hunks)
• docs/en/gitops/how_to/argocd_git.mdx (0 hunks)
• docs/en/gitops/how_to/argocd_info.mdx (0 hunks)
• docs/en/gitops/how_to/create_application_by_argocd_dashoard.mdx (0 hunks)
• docs/en/gitops/how_to/create_gitops_app.mdx (0 hunks)
• docs/en/gitops/how_to/index.mdx (0 hunks)
• docs/en/gitops/index.mdx (1 hunks)
• docs/en/gitops/install_gitops/index.mdx (0 hunks)
• docs/en/gitops/install_gitops/install_argocd_operator.mdx (0 hunks)
• docs/en/gitops/install_gitops/install_gitops_plugin.mdx (0 hunks)
• docs/en/gitops/install_gitops/upgrade_argocd_operator.mdx (0 hunks)
• docs/en/gitops/intro.mdx (0 hunks)
• docs/en/gitops/upgrade/index.mdx (0 hunks)
• docs/en/gitops/upgrade/upgrade_gitops_plugin.mdx (0 hunks)
• sites.yaml (1 hunks)

💤 Files with no reviewable changes (36)

• docs/en/gitops/concept/index.mdx
• docs/en/gitops/architecture.mdx
• docs/en/gitops/concept/alauda_gitops_concept_info/alauda_gitops_concept_argocd.mdx
• docs/en/gitops/functions/create_argocd_application/index.mdx
• docs/en/gitops/functions/argocd_observability/argocd_operator_observability.mdx
• docs/en/gitops/install_gitops/upgrade_argocd_operator.mdx
• docs/en/gitops/upgrade/index.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_directory.mdx
• docs/en/gitops/install_gitops/index.mdx
• docs/en/gitops/concept/alauda_gitops_concept_info/index.mdx
• docs/en/gitops/how_to/index.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_applicationset.mdx
• docs/en/gitops/functions/index.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_application.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_kustomize.mdx
• docs/en/gitops/how_to/create_gitops_app.mdx
• docs/en/gitops/concept/argocd_concept_info/gitops_concept_argocd.mdx
• docs/en/gitops/concept/argocd_concept_info/index.mdx
• docs/en/gitops/functions/create_argocd_application/create_applicationset_via_platform.mdx
• docs/en/gitops/functions/argocd_observability/index.mdx
• docs/en/gitops/how_to/create_application_by_argocd_dashoard.mdx
• docs/en/gitops/how_to/argocd_git.mdx
• docs/en/gitops/how_to/argocd_info.mdx
• docs/en/gitops/install_gitops/install_argocd_operator.mdx
• docs/en/gitops/install_gitops/install_gitops_plugin.mdx
• docs/en/gitops/concept/gitops_concept_infro.mdx
• docs/en/gitops/functions/argocd_observability/gitops_application_alert.mdx
• docs/en/gitops/concept/alauda_gitops_concept_info/alauda_gitops_concept_argocd_status.mdx
• docs/en/gitops/functions/create_argocd_application/create_application_via_platform.mdx
• docs/en/gitops/intro.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_tool_helm.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_sync.mdx
• docs/en/gitops/upgrade/upgrade_gitops_plugin.mdx
• docs/en/gitops/argocd_troubleshooting.mdx
• docs/en/gitops/concept/argocd_concept_info/concept_argocd_health.mdx

🔇 Additional comments (2)

docs/en/gitops/index.mdx (1)

5-6: Titles align with branding; confirm Chinese localization

EN and zh both read "Alauda Container Platform GitOps" in docs/en/gitops/index.mdx (lines 5–6); ExternalSite is used at docs/en/gitops/gitops.mdx:6 and sites.yaml has name: gitops / base: /gitops (≈lines 113/117). Confirm whether the zh title should be localized or remain identical.

sites.yaml (1)

113-119: Verification incomplete — automated checks errored; verify the new gitops entry manually

ripgrep/regex errors prevented conclusive results. Actions to take:

• File: sites.yaml (lines 113–119) — ensure name and base are unique.
• Confirm the repo from the entry and that version "4.0" corresponds to an existing tag/branch or valid docs version.
• Suggested local checks:
  awk '/^\s*-\sname:/{print $NF}' sites.yaml | sort | uniq -c | sort -nr
  awk '/^\sbase:/{print $2}' sites.yaml | sort | uniq -c | sort -nr
  sed -n '110,125p' sites.yaml
  git ls-remote --tags --heads | rg '4.0' || echo "no 4.0 tag/branch"
  rg -n 'gitops/' docs -g '!/node_modules/' || echo "no obvious stale GitOps links"