chore: restructure Install category with JTBD and CQA 2.1 compliance (#3077) (#3100)

Reorganize the Install section of the Administration Guide using
Jobs-to-Be-Done methodology and Red Hat CQA 2.1 editorial standards.

Changes:
- Rename 14 install files with CQA content type prefixes (proc_, ref_)
- Apply CQA to 8 shared files using downstream CQA-compliant content
- Apply CQA from scratch to 6 upstream-only files
- Restructure nav.adoc into job-based groups: Deploy on OpenShift,
  Deploy on Kubernetes, Deploy locally, Deploy in restricted environment
- Rewrite all abstracts with WHY-first JTBD framing
- Fix titles to imperative form, prerequisites to user-first declarative
- Standardize source blocks, verification sections, additional resources
- Add page-aliases for all renamed files to preserve backward compat
- Remove thin wrapper pages (installing-che-in-the-cloud, installing-che-locally)
- Update all xrefs across nav.adoc, snippets, and referencing pages

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

Author: gtrivedi88

modules/administration-guide/examples/snip_che-installing-che.adoc

@@ -10,17 +10,17 @@ The installation method depends on the target platform and the environment restr
 
 You can deploy only one instance of {prod-short} per cluster.
 
-* xref:installing-che-on-openshift-using-cli.adoc[]
-* xref:installing-che-on-openshift-using-the-web-console.adoc[]
-* xref:installing-che-on-openshift-with-keycloak-as-oidc.adoc[]
-* xref:installing-che-in-a-restricted-environment.adoc[]
+* 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[]
+* xref:proc_installing-che-in-a-restricted-environment.adoc[]
 * xref:installing-che-on-microsoft-azure.adoc[]
 * xref:installing-che-on-amazon-elastic-kubernetes-service.adoc[]
 
 .Installing {prod-short} on a local single-node cluster
 
-Single-node clusters are suited only for testing or development. Do *not* use such clusters to run {prod-short} for organizations or developer teams.
+Single-node clusters are suited only for testing or development. Do not use such clusters to run {prod-short} for organizations or developer teams.
 
-* xref:installing-che-on-red-hat-openshift-local.adoc[]
-* xref:installing-che-on-minikube.adoc[]
-* xref:installing-che-on-minikube-keycloak-oidc.adoc[]
+* 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[]

modules/administration-guide/nav.adoc

@@ -16,23 +16,26 @@
 *** xref:user-workspaces.adoc[]
 ** xref:calculating-che-resource-requirements.adoc[]
 * xref:running-at-scale.adoc[]
+// Install
 * xref:installing-che.adoc[]
-** xref:installing-che-on-the-virtual-kubernetes-cluster.adoc[]
-** xref:installing-che-in-the-cloud.adoc[]
-*** xref:installing-che-on-openshift-using-cli.adoc[]
-*** xref:installing-che-on-openshift-using-the-web-console.adoc[]
-*** xref:installing-che-on-openshift-with-keycloak-as-oidc.adoc[]
-*** xref:installing-che-in-a-restricted-environment.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:installing-che-locally.adoc[]
-*** xref:installing-che-on-red-hat-openshift-local.adoc[]
-*** xref:installing-che-on-minikube.adoc[]
-*** xref:installing-che-on-minikube-keycloak-oidc.adoc[]
-** xref:finding-the-fully-qualified-domain-name-fqdn.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:permissions-to-install-che-on-openshift-using-cli.adoc[]
-*** xref:permissions-to-install-che-on-openshift-using-the-web-console.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[]
@@ -134,4 +137,4 @@
 ** 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:uninstalling-che.adoc[]
+* xref:proc_uninstalling-che.adoc[]

modules/administration-guide/pages/finding-the-fully-qualified-domain-name-fqdn.adoc

@@ -1,24 +1,23 @@
 :_content-type: ASSEMBLY
-:description: Installing {prod-short} on {eks}
-:keywords: overview, installing-{prod-id-short}-on-amazon-elastic-kubernetes-service.adoc
-:navtitle: Installing {prod-short} on {eks}
+:description: To provide cloud development environments on AWS, deploy {prod-short} on an Amazon EKS cluster with DNS, TLS certificates, and Keycloak as the OIDC identity provider.
+:keywords: overview, installing-{prod-id-short}-on-amazon-elastic-kubernetes-service
+:navtitle: Install {prod-short} on {eks}
 
-[id="installing-{prod-id-short}-on-amazon-elastic-kubernetes-service.adoc"]
-= Installing {prod-short} on {eks}
+[id="installing-{prod-id-short}-on-amazon-elastic-kubernetes-service"]
+= Install {prod-short} on {eks}
 
-{eks} (Amazon EKS) is a managed {kubernetes} service to run {kubernetes} in the AWS cloud and on-premises data centers.
-
-Follow the instructions below to install and enable {prod-short} on {eks-short}.
+[role="_abstract"]
+To provide cloud development environments on AWS, deploy {prod-short} on an Amazon EKS cluster by configuring DNS, TLS certificates, and Keycloak as the OIDC identity provider.
 
 .Prerequisites
 
-* `helm`: The package manager for {kubernetes}. See: link:https://helm.sh/docs/intro/install/[Installing Helm].
+* You have `helm` installed. See link:https://helm.sh/docs/intro/install/[Installing Helm].
 
-* `{prod-cli}`. See: xref:installing-the-chectl-management-tool.adoc[].
+* You have `{prod-cli}` installed. See xref:installing-the-chectl-management-tool.adoc[].
 
-* `aws`: The AWS Command Line Interface. See: link:https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html[AWS CLI install and update instructions]
+* You have the `aws` CLI installed. See link:https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html[AWS CLI install and update instructions].
 
-* `eksctl`: The Command Line Interface for creating and managing {kubernetes} clusters on {eks-short}. See: link:https://eksctl.io/installation/[Installing eksctl]
+* You have `eksctl` installed. See link:https://eksctl.io/installation/[Installing eksctl].
 
 include::partial$configuring-environment-variables-for-amazon-elastic-kubernetes-service.adoc[leveloffset=+1]
 

modules/administration-guide/pages/installing-che-in-a-restricted-environment.adoc

@@ -1,22 +1,21 @@
 :_content-type: ASSEMBLY
-:description: Installing {prod-short} on Microsoft Azure
+:description: To provide cloud development environments on Microsoft Azure, deploy {prod-short} on an AKS cluster with DNS, TLS certificates, and Keycloak as the OIDC identity provider.
 :keywords: overview, installing-che-on-microsoft-azure
-:navtitle: Installing {prod-short} on Microsoft Azure
+:navtitle: Install {prod-short} on Microsoft Azure
 
 [id="installing-{prod-id-short}-on-microsoft-azure"]
-= Installing {prod-short} on Microsoft Azure
+= Install {prod-short} on Microsoft Azure
 
-Microsoft Azure is a cloud computing service for building, testing, deploying, and managing applications and services through Microsoft-managed data centers.
-
-Follow the instructions below to install and enable {prod-short} on Microsoft Azure.
+[role="_abstract"]
+To provide cloud development environments on Microsoft Azure, deploy {prod-short} on an AKS cluster by configuring DNS, TLS certificates, and Keycloak as the OIDC identity provider.
 
 .Prerequisites
 
-* `helm`: The package manager for {kubernetes}. See: link:https://helm.sh/docs/intro/install/[Installing Helm].
+* You have `helm` installed. See link:https://helm.sh/docs/intro/install/[Installing Helm].
 
-* `az`:  The Microsoft Azure CLI command line tool. See: link:https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest[How to install Microsoft Azure CLI].
+* You have the `az` CLI installed. See link:https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest[How to install Microsoft Azure CLI].
 
-* `kubelogin`: The credential plugin. See: link:https://learn.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest#az-aks-install-cli[How to install kubelogin].
+* You have `kubelogin` installed. See link:https://learn.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest#az-aks-install-cli[How to install kubelogin].
 
 include::partial$proc_preparing-microsoft-azure-for-installing-che.adoc[leveloffset=+1]