Restructure Fabric docs (#17111)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: lightningforever

docs/source-fabric/fundamentals/convert.rst

@@ -119,13 +119,13 @@ Next steps
     :button_link: accelerators.html
     :col_css: col-md-4
     :height: 150
-    :tag: intermediate
+    :tag: basic
 
 .. displayitem::
     :header: Build your own Trainer
     :description: Learn how to build a trainer tailored for you
     :col_css: col-md-4
-    :button_link: ../index.html#build-your-own-trainer
+    :button_link: ../levels/intermediate
     :height: 150
     :tag: intermediate
 

docs/source-fabric/fundamentals/launch.rst

@@ -226,7 +226,7 @@ Next steps
     :col_css: col-md-4
     :button_link: ../fundamentals/precision.html
     :height: 160
-    :tag: intermediate
+    :tag: basic
 
 .. displayitem::
     :header: Distributed Communication

docs/source-fabric/index.rst

@@ -1,8 +1,8 @@
 .. include:: links.rst
 
-################
-Lightning Fabric
-################
+####################
+Welcome to ⚡ Fabric
+####################
 
 Fabric is the fast and lightweight way to scale PyTorch models without boilerplate code.
 
@@ -102,173 +102,6 @@ Fabric ships directly with Lightning. Install it with
 
 For alternative ways to install, read the :doc:`installation guide <fundamentals/installation>`.
 
-----
-
-
-************
-Fundamentals
-************
-
-.. raw:: html
-
-    <div class="display-card-container">
-        <div class="row">
-
-.. displayitem::
-    :header: Getting Started
-    :description: Learn how to add Fabric to your PyTorch code
-    :button_link: fundamentals/convert.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Accelerators
-    :description: Take advantage of your hardware with a switch of a flag
-    :button_link: fundamentals/accelerators.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: intermediate
-
-.. displayitem::
-    :header: Code Structure
-    :description: Best practices for setting up your training script with Fabric
-    :button_link: fundamentals/code_structure.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Launch Distributed Training
-    :description: Launch a Python script on multiple devices and machines
-    :button_link: fundamentals/launch.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: intermediate
-
-.. displayitem::
-    :header: Fabric in Notebooks
-    :description: Launch on multiple devices from within a Jupyter notebook
-    :button_link: fundamentals/notebooks.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Mixed Precision Training
-    :description: Save memory and speed up training using mixed precision
-    :button_link: fundamentals/precision.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: intermediate
-
-.. raw:: html
-
-        </div>
-    </div>
-
-
-----
-
-
-**********************
-Build Your Own Trainer
-**********************
-
-.. raw:: html
-
-    <div class="display-card-container">
-        <div class="row">
-
-.. displayitem::
-    :header: The LightningModule
-    :description: Organize your code in a LightningModule and use it with Fabric
-    :button_link: guide/lightning_module.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Callbacks
-    :description: Make use of the Callback system in Fabric
-    :button_link: guide/callbacks.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Logging
-    :description: Learn how Fabric helps you remove boilerplate code for tracking metrics with a logger
-    :button_link: guide/logging.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Checkpoints
-    :description: Efficient saving and loading of model weights, training state, hyperparameters and more.
-    :button_link: guide/checkpoint.html
-    :col_css: col-md-4
-    :height: 150
-    :tag: basic
-
-.. displayitem::
-    :header: Trainer Template
-    :description: Take our Fabric Trainer template and customize it for your needs
-    :button_link: https://github.com/Lightning-AI/lightning/tree/master/examples/fabric/build_your_own_trainer
-    :col_css: col-md-4
-    :height: 150
-    :tag: intermediate
-
-.. raw:: html
-
-        </div>
-    </div>
-
-
-----
-
-
-***************
-Advanced Topics
-***************
-
-.. raw:: html
-
-    <div class="display-card-container">
-        <div class="row">
-
-.. displayitem::
-    :header: Efficient Gradient Accumulation
-    :description: Learn how to perform efficient gradient accumulation in distributed settings
-    :button_link: advanced/gradient_accumulation.html
-    :col_css: col-md-4
-    :height: 160
-    :tag: advanced
-
-.. displayitem::
-    :header: Distributed Communication
-    :description: Learn all about communication primitives for distributed operation. Gather, reduce, broadcast, etc.
-    :button_link: advanced/distributed_communication.html
-    :col_css: col-md-4
-    :height: 160
-    :tag: advanced
-
-.. displayitem::
-    :header: Multiple Models and Optimizers
-    :description: See how flexible Fabric is to work with multiple models and optimizers!
-    :button_link: advanced/multiple_setup.html
-    :col_css: col-md-4
-    :height: 160
-    :tag: advanced
-
-.. raw:: html
-
-        </div>
-    </div>
-
-
-----
 
 
 .. raw:: html
@@ -278,60 +111,40 @@ Advanced Topics
 .. toctree::
     :maxdepth: 1
     :name: start
-    :caption: Get Started
-
-    Fabric in 5 minutes <fundamentals/convert>
-    Installation <fundamentals/installation>
-
-.. toctree::
-    :maxdepth: 1
-    :name: fundamentals
-    :caption: Fundamentals
+    :caption: Home
 
-    Accelerators <fundamentals/accelerators>
-    Code Structure <fundamentals/code_structure>
-    Launch Distributed Training <fundamentals/launch>
-    Fabric in Notebooks <fundamentals/notebooks>
-    Mixed Precision Training <fundamentals/precision>
+    self
+    Install <fundamentals/installation>
 
-.. toctree::
-    :maxdepth: 1
-    :name: byot
-    :caption: Build Your Own Trainer
-
-    The LightningModule <guide/lightning_module>
-    Callbacks <guide/callbacks>
-    Logging <guide/logging>
-    Checkpoints <guide/checkpoint>
-    Trainer Template <https://github.com/Lightning-AI/lightning/tree/master/examples/fabric/build_your_own_trainer>
 
 .. toctree::
-    :maxdepth: 1
-    :name: advanced
-    :caption: Advanced Topics
+   :maxdepth: 1
+   :caption: Get started in steps
 
-    Efficient Gradient Accumulation <advanced/gradient_accumulation>
-    Distributed Communication <advanced/distributed_communication>
-    Multiple Models and Optimizers <advanced/multiple_setup>
-
-.. toctree::
-    :maxdepth: 1
-    :name: examples
-    :caption: Examples
+   Basic <levels/basic>
+   Intermediate <levels/intermediate>
+   Advanced <levels/advanced>
 
-    Examples <examples/index>
 
 .. toctree::
     :maxdepth: 1
     :name: api
-    :caption: API Reference
+    :caption: Core API Reference
 
     Fabric Arguments <api/fabric_args>
     Fabric Methods <api/fabric_methods>
     Utilities <api/utilities>
     Full API Reference <api_reference>
 
 
+.. toctree::
+    :maxdepth: 1
+    :name: more
+    :caption: More
+
+    Examples <examples/index>
+
+
 .. raw:: html
 
     </div>

docs/source-fabric/levels/advanced.rst

@@ -0,0 +1,46 @@
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+    <../advanced/gradient_accumulation>
+    <../advanced/distributed_communication>
+    <../advanced/multiple_setup>
+
+
+###############
+Advanced skills
+###############
+
+.. raw:: html
+
+    <div class="display-card-container">
+        <div class="row">
+
+.. displayitem::
+    :header: Efficient Gradient Accumulation
+    :description: Learn how to perform efficient gradient accumulation in distributed settings
+    :button_link: ../advanced/gradient_accumulation.html
+    :col_css: col-md-4
+    :height: 160
+    :tag: advanced
+
+.. displayitem::
+    :header: Distributed Communication
+    :description: Learn all about communication primitives for distributed operation. Gather, reduce, broadcast, etc.
+    :button_link: ../advanced/distributed_communication.html
+    :col_css: col-md-4
+    :height: 160
+    :tag: advanced
+
+.. displayitem::
+    :header: Multiple Models and Optimizers
+    :description: See how flexible Fabric is to work with multiple models and optimizers!
+    :button_link: ../advanced/multiple_setup.html
+    :col_css: col-md-4
+    :height: 160
+    :tag: advanced
+
+.. raw:: html
+
+        </div>
+    </div>