From 11830529a7f0cc430fa2af634c367ca34a2f875d Mon Sep 17 00:00:00 2001
From: Eddy Zhou <71026430+Edwardius@users.noreply.github.com>
Date: Tue, 4 Jun 2024 22:30:06 -0700
Subject: [PATCH] Reword Machine Usage Guide (#2852)

Advertises SLURM better
---
 .../compute-cluster/machine-usage-guide.mdx   | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/pages/docs/compute-cluster/machine-usage-guide.mdx b/pages/docs/compute-cluster/machine-usage-guide.mdx
index 83223fb..ef8e5a9 100644
--- a/pages/docs/compute-cluster/machine-usage-guide.mdx
+++ b/pages/docs/compute-cluster/machine-usage-guide.mdx
@@ -7,19 +7,24 @@ It also includes guidelines for using the machines, troubleshoot instructions fo
 
 There are two main types of machines in the cluster: [general-use machines](/machines#general-use-machines) and [SLURM compute nodes](/machines#slurm-compute-nodes).
 
-General-use machines are meant for interactive use and are shared among all users in the cluster.
-You can access them via [SSH](./ssh).
+### SLURM Machines
 
-SLURM compute nodes are meant for running resource-intensive jobs.
-They are managed by a popular HPC[^hpc] job scheduler called SLURM[^slurm].
-Instructions for submitting jobs to the SLURM cluster can be found [here](./slurm).
+Simple Linux Utility for Resource Management (SLURM) is an open-source job scheduler that allocates resources to jobs on a cluster of computers.
+It is widely used in HPC[^hpc] environments.
+
+SLURM machines can be used for both interactive development as well as job scheduling. They provide fair, stable, and secure access to WATcloud's most precious resources (eg. GPUs).
+
+[Instructions for using our SLURM cluster can be found here.](./slurm)
 
 [^hpc]: [High-performance computing](https://en.wikipedia.org/wiki/High-performance_computing) (HPC) is the use of supercomputers and parallel processing
   techniques to solve complex computational problems. Examples of HPC clusters include [Cedar](https://docs.computecanada.ca/wiki/Cedar) and
   [Graham](https://docs.computecanada.ca/wiki/Graham).
 
-[^slurm]: Simple Linux Utility for Resource Management (SLURM) is an open-source job scheduler that allocates resources to jobs on a cluster of computers.
-  It is widely used in HPC environments. Learn more about SLURM [here](https://slurm.schedmd.com/quickstart.html).
+### General-Use Machines
+
+General-use machines are meant for interactive use only. They are an insecure and unstable resource shared amongst all users in the cluster. Going forward, WATcloud will be phasing out General-use Machines in favour of SLURM.
+
+[Instructions for using our General-Use Machines can be found here.](./ssh)
 
 ## Hardware