Moving Ray Clusters restructuring section to be subpage under existing Ray Clusters. (#27036)

This PR puts the Ray Clusters (under construction) docs section (see #26754) under Ray Clusters as a subpage.

This makes the master branch docs clean and presentable for users
Ray Clusters doc writers can use existing CI to iterate on the docs, without having a massive PR once we're done.

Signed-off-by: Cade Daniel <cade@anyscale.com>

doc/source/_toc.yml

@@ -266,75 +266,75 @@ parts:
       - file: cluster/deploy
       - file: cluster/api
       - file: cluster/usage-stats
-
-  - caption: Ray Clusters (under construction)
-    chapters:
-      - file: cluster_under_construction/getting-started
-        title: Getting Started
-      - file: cluster_under_construction/key-concepts
-        title: Key Concepts
-      - file: cluster_under_construction/ray-clusters-on-kubernetes/index
-        title: Ray Clusters on Kubernetes
+      - file: cluster/cluster_under_construction
+        title: Ray Clusters (under construction)
         sections:
-        - file: cluster_under_construction/ray-clusters-on-kubernetes/getting-started
-        - file: cluster_under_construction/ray-clusters-on-kubernetes/user-guides
-        - file: cluster_under_construction/ray-clusters-on-kubernetes/examples
-        - file: cluster_under_construction/ray-clusters-on-kubernetes/references
-      - file: cluster_under_construction/ray-clusters-on-vms/index
-        title: Ray Clusters on VMs
-        sections:
-        - file: cluster_under_construction/ray-clusters-on-vms/getting-started
-        - file: cluster_under_construction/ray-clusters-on-vms/user-guides/index
-          title: User Guides
-          sections:
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/installing-ray
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/index
-            title: Launching Clusters
+          - file: cluster/cluster_under_construction/getting-started
+            title: Getting Started
+          - file: cluster/cluster_under_construction/key-concepts
+            title: Key Concepts
+          - file: cluster/cluster_under_construction/ray-clusters-on-kubernetes/index
+            title: Ray Clusters on Kubernetes
             sections:
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/aws
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/azure
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/gcp
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/add-your-own-cloud-provider
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-ray-cluster-on-prem
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/monitoring-and-observing-ray-cluster
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/manual-cluster-setup
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/large-cluster-best-practices
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/multi-tenancy-best-practices
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/configuring-autoscaling
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/index
-            title: Community-supported Cluster Managers
+            - file: cluster/cluster_under_construction/ray-clusters-on-kubernetes/getting-started
+            - file: cluster/cluster_under_construction/ray-clusters-on-kubernetes/user-guides
+            - file: cluster/cluster_under_construction/ray-clusters-on-kubernetes/examples
+            - file: cluster/cluster_under_construction/ray-clusters-on-kubernetes/references
+          - file: cluster/cluster_under_construction/ray-clusters-on-vms/index
+            title: Ray Clusters on VMs
             sections:
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/yarn
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/slurm
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/lsf
-          - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/index
-            title: Running Jobs
-            sections:
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-cli
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-sdk
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-rest
-            - file: cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/ray-client
-        - file: cluster_under_construction/ray-clusters-on-vms/examples/index
-          title: Examples
-          sections:
-          - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/index
-            sections:
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/launching-ray-cluster
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/running-job-via-job-submission
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/scale-your-job-with-autoscaling
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/observe-your-app
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/shutting-down-your-ray-cluster
-          - file: cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-development/index
-            sections:
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-development/todo
-          - file: cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-production/index
-            sections:
-              - file: cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-production/todo
-        - file: cluster_under_construction/ray-clusters-on-vms/references/index
-          sections:
-            - file: cluster_under_construction/ray-clusters-on-vms/references/job-submission-apis
-            - file: cluster_under_construction/ray-clusters-on-vms/references/ray-cluster-configuration
-            - file: cluster_under_construction/ray-clusters-on-vms/references/ray-job-submission
+            - file: cluster/cluster_under_construction/ray-clusters-on-vms/getting-started
+            - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/index
+              title: User Guides
+              sections:
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/installing-ray
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/index
+                title: Launching Clusters
+                sections:
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/aws
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/azure
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/gcp
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/launching-clusters/add-your-own-cloud-provider
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-ray-cluster-on-prem
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/monitoring-and-observing-ray-cluster
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/manual-cluster-setup
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/large-cluster-best-practices
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/multi-tenancy-best-practices
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/configuring-autoscaling
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/index
+                title: Community-supported Cluster Managers
+                sections:
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/yarn
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/slurm
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/community-supported-cluster-manager/lsf
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/index
+                title: Running Jobs
+                sections:
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-cli
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-sdk
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/job-submission-rest
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/user-guides/running-jobs/ray-client
+            - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/index
+              title: Examples
+              sections:
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/index
+                sections:
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/launching-ray-cluster
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/running-job-via-job-submission
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/scale-your-job-with-autoscaling
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/observe-your-app
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/learn-ray-cluster-basics/shutting-down-your-ray-cluster
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-development/index
+                sections:
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-development/todo
+              - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-production/index
+                sections:
+                  - file: cluster/cluster_under_construction/ray-clusters-on-vms/examples/setting-up-ray-cluster-for-production/todo
+            - file: cluster/cluster_under_construction/ray-clusters-on-vms/references/index
+              sections:
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/references/job-submission-apis
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/references/ray-cluster-configuration
+                - file: cluster/cluster_under_construction/ray-clusters-on-vms/references/ray-job-submission
 
   - caption: References
     chapters:

doc/source/cluster/cluster_under_construction.md

@@ -0,0 +1,4 @@
+# Ray Clusters (under construction)
+:::{warning}
+This page is under construction!
+:::