nesi · jen-reeve · Oct 7, 2025 · Dec 4, 2025 · Dec 4, 2025 · Jan 7, 2026
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -47,6 +47,15 @@
             "args": ["checks/fail_checks.md"],
             "console": "integratedTerminal",
             "justMyCode": true
+        },
+        {
+            "name": "Debug General",
+            "type": "debugpy",
+            "request": "launch",
+            "program": ".venv/bin/mkdocs",
+            "args": ["build"],
+            "console": "integratedTerminal",
+            "justMyCode": true
         }
     ]
 }
diff --git a/docs/.pages.yml b/docs/.pages.yml
@@ -8,3 +8,4 @@ nav:
     - Data_Transfer
     - Policy
     - Service_Subscriptions
+    - Tutorials
diff --git a/docs/Batch_Computing/.pages.yml b/docs/Batch_Computing/.pages.yml
@@ -1,10 +1,10 @@
 nav:
  - Batch_Computing_Guide.md
- - Submitting_your_first_job.md
  - Hardware.md
  - Job_prioritisation.md
  - SLURM-Best_Practice.md
  - Using_GPUs.md
  - Job_Checkpointing.md
  - Fair_Share.md
+ - Checksums.md
  - "*"
diff --git a/docs/Batch_Computing/Batch_Computing_Guide.md b/docs/Batch_Computing/Batch_Computing_Guide.md
@@ -16,7 +16,8 @@ Depending on the needs of your batch jobs, you may need to specify the partition
 
 ## Slurm job basics
 
-Please see [Submitting your first job](Submitting_your_first_job.md) for a detailed tutorial with instructions and examples.
+Please see [Submitting your first job](Tutorial:_Submitting_your_first_job.md) for a detailed tutorial with instructions and examples.
+We also have a [Slurm reference sheet](../Getting_Started/Cheat_Sheets/Slurm-Reference_Sheet.md).
 
 ### Batch scripts
 

diff --git a/docs/Batch_Computing/Submitting_your_first_job.md b/docs/Batch_Computing/Submitting_your_first_job.md
diff --git a/docs/Batch_Computing/Using_GPUs.md b/docs/Batch_Computing/Using_GPUs.md
@@ -18,7 +18,7 @@ This page provides generic information about how to access GPUs through the Slur
 
 ## Request GPU resources using Slurm
 
-To request a GPU for your [Slurm job](Submitting_your_first_job.md), add
+To request a GPU for your [Slurm job](Tutorial:_Submitting_your_first_job.md), add
 the following option in the header of your submission script:
 
 ```sl

diff --git a/docs/FORMAT.md b/docs/FORMAT.md
@@ -156,6 +156,22 @@ There are various flavors.
     Automatically added to pages with the `status:deprecated`, should be used when page is out of date.
     *This page is rubbish!*
 
+!!! time "30 Minutes (for use in tutorial pages)"
+
+!!! objectives
+    - For use in tutorials
+    - learning goal one.
+    - learning goal two.
+
+!!! keypoints
+    - For use in tutorials
+    - should summarize learning goal one.
+    - should summarize learning goal two.
+
+!!! next
+    - For use in tutorials
+    - should link to next lesson.
+
 ??? warning "Extra Admonitions you probably won't need"
     !!! note
         Use `info` instead of this.
@@ -172,116 +188,6 @@ There are various flavors.
     !!! quote
         Havn't seen a reason to use this yet.
 
-    !!! pied-piper
-        don't use this (unless Dini).
-
-    !!! desktop-download-24
-        don't use this (unless Dini).
-
-    !!! magnifying-glass
-        don't use this (unless Dini).
-
-    !!! microscope
-        don't use this (unless Dini).
-
-    !!! vial-virus
-        don't use this (unless Dini).
-
-    !!! database
-        don't use this (unless Dini).
-
-    !!! folder-open
-        don't use this (unless Dini).
-
-    !!! backward
-        don't use this (unless Dini).
-
-    !!! jupyter
-        don't use this (unless Dini).
-
-    !!! terminal
-        don't use this (unless Dini).
-
-    !!! r-project
-        don't use this (unless Dini).
-
-    !!! calendar-days
-        don't use this (unless Dini).
-
-    !!! bell
-        don't use this (unless Dini).
-
-    !!! comment-dots
-        don't use this (unless Dini).
-
-    !!! check-to-slot
-        don't use this (unless Dini).
-
-    !!! square-xmark
-        don't use this (unless Dini).
-
-    !!! rectangle-list
-        don't use this (unless Dini).
-
-    !!! screwdriver-wrench
-        don't use this (unless Dini).
-
-    !!! linux
-        don't use this (unless Dini).
-
-    !!! code-compare
-        don't use this (unless Dini).
-
-    !!! heading
-        don't use this (unless Dini).
-
-    !!! space-awesome
-        don't use this (unless Dini).
-
-    !!! stethoscope
-        don't use this (unless Dini).
-
-    !!! key
-        don't use this (unless Dini).
-
-    !!! users-line
-        don't use this (unless Dini).
-
-    !!! file-code
-        don't use this (unless Dini).
-
-    !!! hand-holding-dollar
-        don't use this (unless Dini).
-
-    !!! circle-question
-        don't use this (unless Dini).
-
-    !!! microphone
-        don't use this (unless Dini).
-
-    !!! tower-observation
-        don't use this (unless Dini).
-
-    !!! circle-info
-        don't use this (unless Dini).
-
-    !!! icon--python
-        don't use this (unless Dini).
-
-    !!! quote-right
-        don't use this (unless Dini).
-
-    !!! image
-        don't use this (unless Dini).
-
-    !!! table
-        don't use this (unless Dini).
-
-    !!! glass-chart
-        don't use this (unless Dini).
-
-    !!! file-export
-        don't use this (unless Dini).
 
 ## Code
 

diff --git a/docs/Getting_Started/Accessing_the_HPCs/VSCode.md b/docs/Getting_Started/Accessing_the_HPCs/VSCode.md
@@ -83,7 +83,7 @@ Clicking on these will open a connection to that machine, you will then be promp
 
 You may find that VSCode is not utilising your preferred versions of software (e.g. when debugging or linting your Python code).
 
-As the NeSI cluster utilises [Environment Modules](../../Batch_Computing/Submitting_your_first_job.md#environment-modules), changing the executable used is not just a matter of changing the path in VSCode configuration, as the libraries required will not be loaded.
+As the NeSI cluster utilises [Environment Modules](../../Tutorials/Introduction_To_HPC/Submitting_Your_First_Job.md#environment-modules), changing the executable used is not just a matter of changing the path in VSCode configuration, as the libraries required will not be loaded.
 
 The only way to make sure that VSCode has access to a suitable environment, is to load the required modules in your `~/.bashrc`
 

diff --git a/docs/Getting_Started/Cheat_Sheets/Slurm-Reference_Sheet.md b/docs/Getting_Started/Cheat_Sheets/Slurm-Reference_Sheet.md
@@ -8,7 +8,7 @@ description: Quick list of the most commonly used Slurm commands, flags, and env
 ---
 
 If you are unsure about using our job scheduler Slurm, more details can
-be found on [Submitting_your_first_job](../../Batch_Computing/Submitting_your_first_job.md).
+be found on [Batch Computing Guide](../../Batch_Computing/Batch_Computing_Guide.md) and we have a self-paced tutorial on [Submitting your first job](../../Tutorials/Introduction_To_HPC/Submitting_Your_First_Job.md).
 
 ## Slurm Commands
 

diff --git a/docs/Interactive_Computing/OnDemand/Apps/JupyterLab/index.md b/docs/Interactive_Computing/OnDemand/Apps/JupyterLab/index.md
@@ -8,7 +8,7 @@ Jupyter allows you to create notebooks that contain live code,
 equations, visualisations and explanatory text. There are many uses for
 Jupyter, including data cleaning, analytics and visualisation, machine
 learning, numerical simulation, managing
-[Slurm job submissions](../../../../Batch_Computing/Submitting_your_first_job.md)
+[Slurm job submissions](../../../../Tutorials/Introduction_To_HPC/Submitting_Your_First_Job.md)
 and workflows and much more.
 
 ## Accessing Jupyter on NeSI