From 9e44074241117a9468267d33eca9c2afc3ac5a2b Mon Sep 17 00:00:00 2001
From: oxu23 <oliverxu23@gmail.com>
Date: Wed, 12 Nov 2025 12:43:06 -0600
Subject: [PATCH 1/2] Add Quick Start page and update toc

---
 .gitignore         |   2 +
 docs/_toc.yml      |   1 +
 docs/quickstart.md | 106 +++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 109 insertions(+)
 create mode 100644 docs/quickstart.md

diff --git a/.gitignore b/.gitignore
index cfc9a260..b6bdf917 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,3 +3,5 @@
 /workshops/minted_cache
 *.sif
 /docs/_build
+READMEOliver.md
+.venv/
diff --git a/docs/_toc.yml b/docs/_toc.yml
index ea93037f..8e9b60d6 100644
--- a/docs/_toc.yml
+++ b/docs/_toc.yml
@@ -39,6 +39,7 @@ parts:
 - caption: How to Use
   chapters:
   - file: portal.md
+  - file: quickstart.md
   - file: tutorials/slurm/slurm.md
     sections:
     - file: tutorials/slurm/best_practices.md
diff --git a/docs/quickstart.md b/docs/quickstart.md
new file mode 100644
index 00000000..da2dbad1
--- /dev/null
+++ b/docs/quickstart.md
@@ -0,0 +1,106 @@
+---
+title: Quick Start
+---
+
+# Quick Start
+
+This guide walks you through accessing the SMU **M3 Cluster** and running your first job using either **SSH** or the **OnDemand Portal**.
+
+---
+
+## Accessing the M3 Cluster via SSH
+
+> Remember to replace example terms (like `username` and `slurm_account_name`) with your own credentials.
+
+### 1. Open a Terminal
+
+- **macOS/Linux:** Open **Terminal**
+- **Windows 11+:** Open **PowerShell**
+
+### 2. Connect to M3
+
+```bash
+ssh username@m3.smu.edu
+```
+
+Enter your SMU password (input will not show on screen)
+
+Authenticate with DUO by pressing 1 for your associated device
+
+### 3. Create a Job Script
+
+Create a new job file using Nano:
+
+```bash
+nano my_first_job.sbatch
+```
+
+Paste the following contents into the editor:
+
+```bash
+#!/bin/bash
+#SBATCH -A slurm_account_name
+#SBATCH -J my_first_job
+#SBATCH -o my_first_job_%j.out
+#SBATCH -e my_first_job_%j.err
+#SBATCH -p dev
+#SBATCH -t 0-00:30:00
+#SBATCH --mem=4G
+#SBATCH -c 1
+
+# Wait for 100 seconds so you can check the queue using 'squeue -u $USER'
+sleep 100
+ 
+# Print a simple message
+echo "Hello, World!"
+```
+
+Save and exit Nano:
+
+```
+Ctrl + X  →  Y  →  Enter
+```
+
+### 4. Submit and Monitor Your Job
+
+Submit your job:
+
+```bash
+sbatch my_first_job.sbatch
+```
+
+Check the job status:
+
+``` bash
+squeue -u $USER
+After completion, view output and error files:
+```
+
+Check the outputs:
+
+``` bash
+cat my_first_job_<jobid>.out
+cat my_first_job_<jobid>.err
+```
+
+## Accessing the M3 Cluster via OnDemand
+
+Connect to PerunaNet or the SMU campus network.
+
+1. Open a browser and visit:
+https://hpc.m3.smu.edu/pun/sys/dashboard/
+
+2. Log in using your SMU credentials.
+
+3. From the top menu, select My Interactive Sessions.
+
+4. On the left sidebar, choose an interactive app (e.g., RStudio, Jupyter, etc.).
+
+5. Select your SLURM account and job settings (defaults are fine for testing).
+
+6. Click Launch and wait for the job to start in the queue.
+
+7. Once ready, click Launch again to open the session in your browser.
+
+When finished, delete the job from My Interactive Sessions to free resources.
+

From c813420ee90c4b7b115c3a3e83f8566932f7306b Mon Sep 17 00:00:00 2001
From: oxu23 <oliverxu23@gmail.com>
Date: Wed, 3 Dec 2025 13:05:02 -0600
Subject: [PATCH 2/2] Update quickstart.md

---
 docs/quickstart.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/docs/quickstart.md b/docs/quickstart.md
index da2dbad1..adeb72b9 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -29,7 +29,7 @@ Authenticate with DUO by pressing 1 for your associated device
 
 ### 3. Create a Job Script
 
-Create a new job file using Nano:
+Create a new job file using nano:
 
 ```bash
 nano my_first_job.sbatch
@@ -48,14 +48,14 @@ Paste the following contents into the editor:
 #SBATCH --mem=4G
 #SBATCH -c 1
 
-# Wait for 100 seconds so you can check the queue using 'squeue -u $USER'
+# Wait for 100 seconds so you can check the queue using 'squeue --me'
 sleep 100
  
 # Print a simple message
 echo "Hello, World!"
 ```
 
-Save and exit Nano:
+Save and exit nano:
 
 ```
 Ctrl + X  →  Y  →  Enter
@@ -72,8 +72,7 @@ sbatch my_first_job.sbatch
 Check the job status:
 
 ``` bash
-squeue -u $USER
-After completion, view output and error files:
+squeue --me
 ```
 
 Check the outputs:
@@ -88,7 +87,7 @@ cat my_first_job_<jobid>.err
 Connect to PerunaNet or the SMU campus network.
 
 1. Open a browser and visit:
-https://hpc.m3.smu.edu/pun/sys/dashboard/
+https://hpc.smu.edu
 
 2. Log in using your SMU credentials.