[wip][train] update Ray Train documentation (quickstart, user guides)

doc/source/_static/js/custom.js

@@ -48,7 +48,7 @@ document.addEventListener("DOMContentLoaded", function() {
             // Ray Train
             "Ray Train", "Ray Train API",
             "Distributed PyTorch", "Advanced Topics", "More Frameworks",
-            "Ray Train Internals",
+            "Ray Train Internals", "Getting Started with Other Frameworks",
             // Ray Tune
             "Ray Tune", "Ray Tune Examples", "Ray Tune API",
             // Ray Serve

doc/source/_toc.yml

@@ -60,31 +60,21 @@ parts:
         title: Ray Train
         sections:
           - file: train/key-concepts
-            title: "Key Concepts"
-          - file: train/distributed-pytorch
-            sections:
-              - file: train/distributed-pytorch/converting-existing-training-loop
-              - file: train/distributed-pytorch/data-loading-preprocessing
-              - file: train/distributed-pytorch/using-gpus
-              - file: train/distributed-pytorch/persistent-storage
-                title: Configuring Persistent Storage
-              - file: train/distributed-pytorch/monitoring-logging
-              - file: train/distributed-pytorch/checkpoints
-              - file: train/distributed-pytorch/experiment-tracking
-              - file: train/distributed-pytorch/fault-tolerance
-              - file: train/distributed-pytorch/migration-guides
-                title: Migration Guides
-              - file: train/distributed-pytorch/advanced
-                sections:
-                    - file: train/distributed-pytorch/reproducibility
-                    - file: train/distributed-pytorch/automatic-mixed-precision
-                    - file: train/distributed-pytorch/hyperparameter-optimization
-                      title: Hyperparameter optimization
+            title: Key Concepts
+          - file: train/getting-started-pytorch
+          - file: train/getting-started-pytorch-lightning
           - file: train/more-frameworks
+            title: Getting Started with Other Frameworks
             sections:
+              - file: train/huggingface-transformers-accelerate
+                title: HuggingFace Transformers & Accelerate
               - file: train/distributed-tensorflow-keras
+                title: TensorFlow & Keras
               - file: train/distributed-xgboost-lightgbm
+                title: XGBoost & LightGBM
               - file: train/horovod
+          - file: train/user-guides
+            title: User Guides
           - file: train/internals/index
             sections:
               - file: train/internals/architecture

doc/source/ray-air/api/session.rst

@@ -5,11 +5,6 @@ Ray AIR Session
 
 .. currentmodule:: ray.air
 
-.. seealso::
-    See this :ref:`Ray Train user guide <train-monitoring>` and
-    this :ref:`Ray Tune user guide <tune-function-api>` for usage examples
-    of ``ray.air.session`` in the respective libraries.
-
 
 Report Metrics and Save Checkpoints
 -----------------------------------

doc/source/train/api/api.rst

@@ -148,7 +148,7 @@ PyTorch Lightning
 
     We will deprecate `LightningTrainer`, `LightningConfigBuilder`,
     `LightningCheckpoint`, and `LightningPredictor` in Ray 2.8. Please 
-    refer to the :ref:`migration guides <migration-guide>` for more info.
+    refer to the :ref:`migration guide <lightning-trainer-migration-guide>` for more info.
 
 Tensorflow/Keras
 ~~~~~~~~~~~~~~~~