chore: promote Install to top-level Antora module (#3102)

* chore: promote Install to top-level Antora module

Move all installation pages, partials, and examples from
administration-guide to a new modules/install/ module, matching the
downstream JTBD category structure. Create installation overview,
verification, and next-steps pages. Update all cross-module xrefs
and includes across admin-guide, overview, and end-user-guide.
Delete dissolved wrapper pages (preparing-the-installation,
permissions-to-install-che). Register discover, plan, and install
module navs in antora.yml.

Depends on: PR #3098 (Discover), PR #3099 (Plan)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: merge Plan content into Install module, retire Plan

Move calculating-che-resource-requirements, running-at-scale, and
installing-the-chectl-management-tool from administration-guide into
the install module. This merges what was planned as a separate Plan
module (PR #3099) directly into Install, matching the downstream
decision to retire the Plan guide.

- Move 3 pages, 4 examples, 1 image to modules/install/
- Add running-at-scale to install/nav.adoc Requirements section
- Update admin-guide nav to remove moved entries
- Convert cross-module xrefs: admin-guide refs to install become local
- Add plan: page-aliases for backward-compatible redirects

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: 3 people

0001-fix-Make-Discover-the-first-top-level-section-per-SM.patch

@@ -0,0 +1,52 @@
+From 3a08d09838b9f195c37b1621f8e5ca99cda998ad Mon Sep 17 00:00:00 2001
+From: Gaurav Trivedi <gtrivedi@redhat.com>
+Date: Tue, 16 Jun 2026 19:59:42 +0530
+Subject: [PATCH] fix: Make Discover the first top-level section per SME
+ feedback
+MIME-Version: 1.0
+Content-Type: text/plain; charset=UTF-8
+Content-Transfer-Encoding: 8bit
+
+Addresses SME feedback from ibuziuk on PR #3098:
+- Move Discover to first position in navigation
+- Include 'Introduction to Che' and 'Eclipse Che hosted by Red Hat' in Discover section
+- Remove redundant overview and hosted-che from main nav (content accessible via Discover)
+- Logical user flow: Discover → Use → Administer
+
+This creates a better user journey where users first discover what Eclipse Che
+is and explore hosted options before diving into detailed architecture.
+
+Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
+---
+ antora.yml                | 2 --
+ modules/discover/nav.adoc | 2 ++
+ 2 files changed, 2 insertions(+), 2 deletions(-)
+
+diff --git a/antora.yml b/antora.yml
+index 805ff274..f40b9f10 100644
+--- a/antora.yml
++++ b/antora.yml
+@@ -5,8 +5,6 @@ version: next
+ prerelease: true
+ start_page: overview:introduction-to-eclipse-che.adoc
+ nav:
+-  - modules/overview/nav.adoc
+-  - modules/hosted-che/nav.adoc
+   - modules/discover/nav.adoc
+   - modules/end-user-guide/nav.adoc
+   - modules/administration-guide/nav.adoc
+diff --git a/modules/discover/nav.adoc b/modules/discover/nav.adoc
+index d21c3f64..f6f27c59 100644
+--- a/modules/discover/nav.adoc
++++ b/modules/discover/nav.adoc
+@@ -1,5 +1,7 @@
+ .Discover
+ 
++* xref:overview:introduction-to-eclipse-che.adoc[]
++* xref:hosted-che:hosted-che.adoc[]
+ * xref:architecture-overview.adoc[]
+ ** xref:server-components.adoc[]
+ *** xref:che-operator.adoc[]
+-- 
+2.54.0
+

antora.yml

@@ -5,7 +5,9 @@ version: next
 prerelease: true
 start_page: overview:introduction-to-eclipse-che.adoc
 nav:
+  - modules/overview/nav.adoc
   - modules/discover/nav.adoc
+  - modules/install/nav.adoc
   - modules/end-user-guide/nav.adoc
   - modules/administration-guide/nav.adoc
   - modules/extensions/nav.adoc

modules/administration-guide/examples/proc_che-configuring-ingresses.adoc

@@ -26,6 +26,6 @@ spec:
 
 .Additional resources
 
-* xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
+* xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
 
 * xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]

modules/administration-guide/examples/snip_che-concealing-editors-additional-resources.adoc

@@ -2,7 +2,7 @@
 
 .Additional resources
 
-* xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
+* xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
 
 * xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]
 

modules/administration-guide/examples/snip_che-upgrading-the-chectl-management-tool.adoc

@@ -4,7 +4,7 @@ This section describes how to upgrade the `{prod-cli}` management tool.
 
 .Prerequisites
 
-* `{prod-cli}`. See: xref:installing-the-chectl-management-tool.adoc[].
+* `{prod-cli}`. See: xref:install:installing-the-chectl-management-tool.adoc[].
 
 .Procedure
 

modules/administration-guide/nav.adoc

@@ -1,33 +1,9 @@
 .Administration Guide
 
 * xref:security-best-practices.adoc[]
-* xref:preparing-the-installation.adoc[]
-** xref:installing-the-chectl-management-tool.adoc[]
-** xref:calculating-che-resource-requirements.adoc[]
-* xref:running-at-scale.adoc[]
-// Install
-* xref:installing-che.adoc[]
-** Deploy on OpenShift
-*** xref:proc_installing-che-on-openshift-using-cli.adoc[]
-*** xref:proc_installing-che-on-openshift-using-the-web-console.adoc[]
-*** xref:proc_installing-che-on-openshift-with-keycloak-as-oidc.adoc[]
-** Deploy on {kubernetes}
-*** xref:installing-che-on-microsoft-azure.adoc[]
-*** xref:installing-che-on-amazon-elastic-kubernetes-service.adoc[]
-*** xref:proc_installing-che-on-the-virtual-kubernetes-cluster.adoc[]
-** Deploy locally
-*** xref:proc_installing-che-on-red-hat-openshift-local.adoc[]
-*** xref:proc_installing-che-on-minikube.adoc[]
-*** xref:proc_installing-che-on-minikube-keycloak-oidc.adoc[]
-** Deploy in a restricted environment
-*** xref:proc_installing-che-in-a-restricted-environment.adoc[]
-** xref:proc_finding-the-fully-qualified-domain-name-fqdn.adoc[]
-** xref:permissions-to-install-che.adoc[]
-*** xref:ref_permissions-to-install-che-on-openshift-using-cli.adoc[]
-*** xref:ref_permissions-to-install-che-on-openshift-using-the-web-console.adoc[]
 * xref:configuring-che.adoc[]
 ** xref:understanding-the-checluster-custom-resource.adoc[]
-*** xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
+*** xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
 *** xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]
 *** xref:checluster-custom-resource-fields-reference.adoc[]
 ** xref:configuring-namespace-provisioning.adoc[]
@@ -128,4 +104,3 @@
 ** xref:upgrading-che-using-the-cli-management-tool.adoc[]
 ** xref:upgrading-che-using-the-cli-management-tool-in-restricted-environment.adoc[]
 ** xref:repairing-the-devworkspace-operator-on-openshift.adoc[]
-* xref:proc_uninstalling-che.adoc[]

modules/administration-guide/pages/configuring-che-hostname.adoc

@@ -66,6 +66,6 @@ spec:
 
 .Additional resources
 
-* xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
+* xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
 
 * xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]

modules/administration-guide/pages/configuring-che-with-self-signed-certificate.adoc

@@ -63,4 +63,4 @@ $ {orch-cli} label secret self-signed-certificate app.kubernetes.io/part-of=che.
 
 .Additional resources
 
-* xref:installing-che.adoc[]
+* xref:install:installing-che.adoc[]

modules/administration-guide/pages/configuring-storage-classes.adoc

@@ -30,7 +30,7 @@ Define a storage class name in the {prod-short} configuration to use the storage
 
 Use CheCluster Custom Resource definition to define storage classes:
 
-. Define storage class names: configure the `CheCluster` Custom Resource, and install {prod-short}. See xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[].
+. Define storage class names: configure the `CheCluster` Custom Resource, and install {prod-short}. See xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[].
 +
 [source,yaml,subs="+quotes,+attributes"]
 ----
@@ -51,6 +51,6 @@ spec:
 
 .Additional resources
 
-* xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
+* xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[]
 
 * xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[]

modules/administration-guide/pages/configuring-storage-sizes.adoc

@@ -35,7 +35,7 @@ per-workspace: 5Gi
 [NOTE]
 ====
 
-* You can set this field at installation. See xref:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[].
+* You can set this field at installation. See xref:install:using-chectl-to-configure-the-checluster-custom-resource-during-installation.adoc[].
 
 * You can update this field on the command line. See xref:using-the-cli-to-configure-the-checluster-custom-resource.adoc[].