fix docs tutorial links and add intro to guides/index.md

Signed-off-by: Hemil Desai <hemild@nvidia.com>

Author: hemildesai

docs/source/guides/index.md

@@ -0,0 +1,41 @@
+Guides
+=================
+
+```{toctree}
+:maxdepth: 2
+
+why-use-nemo-run
+configuration
+execution
+management
+ray
+cli
+```
+
+Welcome to the NeMo-Run guides! This section provides comprehensive documentation on how to use NeMo-Run effectively for your machine learning experiments.
+
+## Getting Started
+
+If you're new to NeMo-Run, we recommend starting with:
+
+- **[Why Use NeMo-Run?](why-use-nemo-run.md)** - Understand the benefits and philosophy behind NeMo-Run
+- **[Configuration](configuration.md)** - Learn how to configure your ML tasks and experiments
+- **[Execution](execution.md)** - Discover how to run your experiments across different computing environments
+- **[Management](management.md)** - Master experiment tracking, reproducibility, and organization
+
+## Advanced Topics
+
+For more advanced usage:
+
+- **[Ray Integration](ray.md)** - Learn how to use NeMo-Run with Ray for distributed computing
+- **[CLI Reference](cli.md)** - Explore the command-line interface for NeMo-Run
+
+## Core Concepts
+
+NeMo-Run is built around three core responsibilities:
+
+1. **Configuration** - Define your ML experiments using a flexible, pythonic configuration system
+2. **Execution** - Run your experiments seamlessly across local machines, Slurm clusters, cloud providers, and more
+3. **Management** - Track, reproduce, and organize your experiments with built-in experiment management
+
+Each guide dives deep into these concepts with practical examples and best practices. Choose a guide above to get started!

docs/source/guides/index.rst

@@ -1,8 +1,8 @@
-# Management
+# Manage NeMo-Run
 
 The central component for management of tasks in NeMo-Run is the `Experiment` class. It allows you to define, launch, and manage complex workflows consisting of multiple tasks. This guide provides an overview of the `Experiment` class, its methods, and how to use it effectively.
 
-## **Creating an Experiment**
+## Creating an Experiment
 
 To create an experiment, you can instantiate the `Experiment` class by passing in a descriptive title:
 
@@ -14,7 +14,7 @@ When executed, it will automatically generate a unique experiment ID for you, wh
 
 > [!NOTE] > `Experiment` is a context manager and `Experiment.add` and `Experiment.run` methods can currently only be used after entering the context manager.
 
-## **Adding Tasks**
+## Adding Tasks
 
 You can add tasks to an experiment using the `add` method. This method supports tasks of the following kind:
 
@@ -50,7 +50,7 @@ with run.Experiment("dag-experiment", log_level="INFO") as exp:
    )
 ```
 
-## **Launching an Experiment**
+## Launching an Experiment
 
 Once you have added all tasks to an experiment, you can launch it using the `run` method. This method takes several optional arguments, including `detach`, `sequential`, and `tail_logs` and `direct`:
 
@@ -65,7 +65,7 @@ with exp:
     exp.run(detach=True, sequential=False, tail_logs=True, direct=False)
 ```
 
-## **Experiment Status**
+## Experiment Status
 
 You can check the status of an experiment using the `status` method:
 
@@ -97,23 +97,23 @@ Task 2: simple.add.add_object
 - Local Directory: /home/your_user/.nemo_run/experiments/experiment_with_scripts/experiment_with_scripts_1730761155/simple.add.add_object
 ```
 
-## **Canceling a Task**
+## Canceling a Task
 
 You can cancel a task using the `cancel` method:
 
 ```python
 exp.cancel("task_id")
 ```
 
-## **Viewing Logs**
+## Viewing Logs
 
 You can view the logs of a task using the `logs` method:
 
 ```python
 exp.logs("task_id")
 ```
 
-## **Experiment output**
+## Experiment output
 
 Once an experiment is run, NeMo-Run displays information on ways to inspect and reproduce past experiments. This allows you to check logs, sync artifacts (in the future), cancel running tasks, and rerun an old experiment.
 

docs/source/guides/management.md

@@ -59,6 +59,6 @@ The ``hello_world`` tutorial series provides a comprehensive introduction to NeM
 
 You can find the tutorial series below:
 
-1. `Part 1 <../../../NeMo-Run/examples/hello-world/hello_world.ipynb>`
-2. `Part 2 <../../../NeMo-Run/examples/hello-world/hello_experiments.ipynb>`
-3. `Part 3 <../../../NeMo-Run/examples/hello-world/hello_scripts.py>`
+1. `Part 1 <../../../examples/hello-world/hello_world.ipynb>`_
+2. `Part 2 <../../../examples/hello-world/hello_experiments.ipynb>`_
+3. `Part 3 <../../../examples/hello-world/hello_scripts.py>`_