[DOCS] Add "choosing how to deploy" section

Also tidy up formatting and remove old comments

docs/source/deployment.md

@@ -1,9 +1,15 @@
+# Deployment
 
 The BRECcIA Network Mapper can be deployed in a variety of ways, most of which utilise Docker.
 Ansible deployment has been tested on RHEL7 and RHEL8.
 
+## Choosing How to Deploy
 
-# Ansible
+If you are an organisation deploying the app on a server, [Ansible](#ansible) is recommended. If Ansible is not used with your server, [Docker Compose](#docker-compose) or [][Vagrant](#vagrant) are recommended.
+
+If you are an individual deploying the app on your local machine, [Docker Desktop](#docker-desktop) is recommended. However, if you are planning on making the app accessible to other people (outside your computer), we advise deploying the app on a server.
+
+## Ansible
 
 Prerequisites:
 
@@ -15,22 +21,10 @@ Deployment with Ansible has been tested on RHEL7 and RHEL8, but is compatible wi
 
 To deploy the BRECcIA Network Mapper with Ansible:
 
-<!-- -------------------------------------------------------
-NOTES
-pull deploy folder only
-navigate to folder
-copy icon to icon-192x192.png in folder
-copy example.env to .env and edit
-copy inventory.example.yml to inventory.yml and edit
-edit playbook if superuser desired
-run playbook
-set provision_superuser to false if was changed
-------------------------------------------------------- -->
-
 1. Download and extract the deployment files from [the latest release](https://github.com/Southampton-RSG/breccia-mapper/releases/latest):
 
     ```bash
-    curl https://github.com/Southampton-RSG/breccia-mapper/releases/latest/download/deploy-ansible.tar | tar xzv && cd deploy-ansible
+    curl https://github.com/Southampton-RSG/breccia-mapper/releases/latest/download/deploy-ansible.tar | tar xzv && cd network-mapper
     ```
 
 2. Copy your logo (192x192 pixels) to `icon-192x192.png` in this folder.
@@ -66,7 +60,7 @@ If you changed the `provision_superuser` variable in `playbook.yml` to `true`, r
 :::
 
 
-# Docker Compose
+## Docker Compose
 
 Prerequisites:
 
@@ -76,23 +70,12 @@ Prerequisites:
 Deployment with Docker has been tested on RHEL7, RHEL8, and Ubuntu 22.04 LTS
 :::
 
-<!-- -------------------------------------------------------
-NOTES
-create folder
-pull docker compose file and example.env only
-copy icon to icon-192x192.png in folder
-copy example.env to .env and edit
-touch db file? (is this needed?)
-run docker compose up -d
-create superuser if desired
-------------------------------------------------------- -->
-
 To deploy the BRECcIA Network Mapper with Docker:
 
 1. Download and extract the deployment files from [the latest release](https://github.com/Southampton-RSG/breccia-mapper/releases/latest):
 
     ```bash
-    curl https://github.com/mgrove36/Southampton-RSG/releases/latest/download/deploy-docker.tar | tar xzv && cd deploy-docker
+    curl https://github.com/mgrove36/Southampton-RSG/releases/latest/download/deploy-docker.tar | tar xzv && cd network-mapper
     ```
 
 2. Copy your logo (192x192 pixels) to `icon-192x192.png` in this folder.
@@ -125,30 +108,19 @@ To deploy the BRECcIA Network Mapper with Docker:
 If you don't create a superuser when you first deploy the app, you will be unable to log in.
 :::
 
-# Vagrant
+## Vagrant
 
 Prerequisites:
 
 - [Vagrant](https://www.vagrantup.com/)
 - [Ansible](https://www.ansible.com/)
 
-<!-- -------------------------------------------------------
-NOTES
-pull deploy folder only
-navigate to folder
-copy icon to icon-192x192.png in folder
-copy example.env to .env and edit
-edit playbook if superuser desired
-run vagrant up and/or vagrant provision
-set provision_superuser to false if was changed
-------------------------------------------------------- -->
-
 To deploy the BRECcIA Network Mapper with Vagrant:
 
 1. Download and extract the deployment files from [the latest release](https://github.com/Southampton-RSG/breccia-mapper/releases/latest):
 
     ```bash
-    curl https://github.com/mgrove36/Southampton-RSG/releases/latest/download/deploy-vagrant.tar | tar xzv && cd deploy-vagrant
+    curl https://github.com/mgrove36/Southampton-RSG/releases/latest/download/deploy-vagrant.tar | tar xzv && cd network-mapper
     ```
 
 2. Copy your logo (192x192 pixels) to `icon-192x192.png` in this folder.
@@ -183,4 +155,7 @@ To deploy the BRECcIA Network Mapper with Vagrant:
 To stop the virtual machine, run `vagrant halt` in this directory. More commands are explained in the [Vagrant docs](https://developer.hashicorp.com/vagrant/docs/cli).
 :::
 
-<!-- # Build From Source -->
+## Docker Desktop
+
+Coming soon.
+