Skip to content

docs: remove GitOps Cloud documentation segment - #1436

Open
idan-codefresh wants to merge 1 commit into
masterfrom
docs/remove-gitops-cloud
Open

docs: remove GitOps Cloud documentation segment#1436
idan-codefresh wants to merge 1 commit into
masterfrom
docs/remove-gitops-cloud

Conversation

@idan-codefresh

Copy link
Copy Markdown
Contributor

Summary

Removes the standalone GitOps Cloud documentation set (the GitOps Cloud option in the header product switcher). It was a parallel copy of the GitOps-relevant subset of the main docs: 122 of 134 pages were byte-identical to their _docs twins and had gone stale (last touched May 2026 vs. _docs actively maintained), so the microsite added maintenance burden without unique value.

Content preserved

The only genuinely unique content is migrated into the main docs:

  • Troubleshooting — the 7 unique GitOps Runtime error scenarios (runtime collision check, CLI upgrade, bootstrap auth, git-integration 404, GraphQL SSL/401 errors, apps-not-synced timeout, and the full "unable to communicate with runtime" browser/SSL/protocol section) merged into _docs/installation/gitops/runtime-troubleshooting.md.
  • SLA — migrated the cleaner footnoted revision to _docs/terms-and-privacy-policy/sla-gitops-cloud.md (added to nav under Terms and Privacy Policy). The existing general sla.md is untouched.

The GitOps Cloud product-positioning pages (what-is-gitops-cloud, explore-gitops-cloud-features) and support pages were intentionally not migrated.

Removed

  • _gitops/ collection (134 pages), _posts-gitops/, gitops/index.html
  • _data/argohub-nav.yml, _data/argohub-home-content.yml
  • _layouts/gitops.html, _includes/argohub-docs-navbar.html, _includes/argohub-docs-sidebar.html.twig
  • assets/js/argohub-redirect/ (switcher JS + redirect map), build/create_symlink.js

Unwired

  • _config.yml: dropped gitops/posts-gitops collections, defaults, and GitOps feed. Retained the gitops_collection variable (with a comment) so the ~137 {% if page.collection == site.gitops_collection %} conditionals in _docs stay valid — they already render the enterprise (non-GitOps-Cloud) branch.
  • _includes/docs-navbar.html: removed the GitOps Cloud / Pipelines & GitOps product switcher dropdown.
  • _includes/scripts.html: removed the redirect script + globals; hardcoded the Amplitude segment to enterprise (previously read a cookie global from the deleted JS).
  • _data/home-content.yml: repointed the one homepage link that went into /gitops/… to its /docs/… twin.
  • _layouts/home.html, package.json, README.md: removed dead GitOps Cloud branches, npm scripts, and docs.

No redirects

Per intent: the GitOps Cloud collection was excluded from indexing (noindex + sitemap: false), so the /gitops/… URLs are not indexed and don't need redirects.

Verification

  • _config.yml and data files parse as valid YAML; collections reduced to posts, pages, docs.
  • Every {% include %} and layout: reference resolves; nothing references the removed gitops layout or argohub includes.
  • No /gitops/ links remain in any kept source file.
  • ⚠️ A full local Jekyll build could not be run in the dev environment (system Ruby needs sudo, Docker not running). Relying on the staging build from this PR to validate the rendered site.

🤖 Generated with Claude Code

Remove the standalone "GitOps Cloud" documentation set, which was a
parallel copy of the GitOps-relevant subset of the main docs. All 122
mapped twin pages were byte-identical to their _docs counterparts and
had gone stale, so the microsite added maintenance burden without unique
value.

Preserve the two pieces of genuinely unique content:
- Merge the unique GitOps Runtime troubleshooting scenarios into
  _docs/installation/gitops/runtime-troubleshooting.md
- Migrate the GitOps Cloud SLA into
  _docs/terms-and-privacy-policy/sla-gitops-cloud.md (added to nav)

Remove the GitOps Cloud infrastructure:
- _gitops/ collection, _posts-gitops/, gitops/index.html
- _data/argohub-nav.yml, _data/argohub-home-content.yml
- _layouts/gitops.html, argohub navbar/sidebar includes
- assets/js/argohub-redirect/ switcher + redirect map, build/create_symlink.js

Unwire references:
- _config.yml: drop gitops/posts-gitops collections, defaults, and feed
  (retain gitops_collection var so legacy _docs conditionals stay valid)
- docs-navbar.html: remove the product switcher dropdown
- scripts.html: drop redirect script/globals; hardcode Amplitude segment
- home-content.yml: repoint the one /gitops/ homepage link to its /docs twin
- home.html, package.json, README.md: remove dead branches, scripts, docs

No redirects added: the GitOps Cloud collection was excluded from
indexing (noindex + sitemap: false), so the /gitops/ URLs are not indexed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@codefresh-git-integration

Copy link
Copy Markdown

"[CI] Staging environment is at https://staging-docs.codefresh.io/docsremove-gitops-cloud/docs/"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant