diff --git a/doc/deployment/Creating-a-release.md b/doc/deployment/Creating-a-release.md
index 03889ba8e..2bb23f2d8 100644
--- a/doc/deployment/Creating-a-release.md
+++ b/doc/deployment/Creating-a-release.md
@@ -60,7 +60,7 @@ is recent enough to include the most recent changes in the
 
 1. Do the same for the `EPICS32` 32-bit build, replacing `EPICS` with `EPICS32` everywhere in the commands above.
 1. Check release is now listed in [`https://control-svcs.isis.cclrc.ac.uk/git/?a=project_list;pf=releases`](https://control-svcs.isis.cclrc.ac.uk/git/?a=project_list;pf=releases)
-1. Run the [`instrument_deploy.yaml` ansible playbook](https://github.com/ISISComputingGroup/ansible-playbooks/tree/main?tab=readme-ov-file#instrument_deployyaml) which currently installs the JDK on instruments. 
+1. Run the [`instrument_deploy.yaml` ansible playbook](https://github.com/ISISComputingGroup/ansible-playbooks/tree/main?tab=readme-ov-file#instrument_deployyaml) on any test machines which will be used for manual system testing. 
 
 
 {#creating_release_testing_steps}
diff --git a/doc/deployment/deploy/Deployment-on-an-Instrument-Control-PC.md b/doc/deployment/deploy/Deployment-on-an-Instrument-Control-PC.md
index e24e8b95c..5a2cde341 100644
--- a/doc/deployment/deploy/Deployment-on-an-Instrument-Control-PC.md
+++ b/doc/deployment/deploy/Deployment-on-an-Instrument-Control-PC.md
@@ -4,6 +4,9 @@ This document describes the steps necessary to install/upgrade IBEX on an Instru
 
 ## Preparatory Steps for Client and Server
 
+Before starting any manual deployments, run the [`instrument_deploy.yaml` ansible playbook](https://github.com/ISISComputingGroup/ansible-playbooks/tree/main?tab=readme-ov-file#instrument_deployyaml) which currently installs the JDK on instruments. This should be run on the relevant deploy group - the playbook will prompt for the hosts to run it on to avoid accidentally deploying to all instruments. As an example, to deploy to the winter group, enter `winter_deploy` (as specified in the [inventory file](https://github.com/ISISComputingGroup/ansible-playbooks/blob/main/hosts.yaml)).
+This playbook has been designed so it is idempotent, ie. if a step has already occurred such as deploying the JDK it will not be repeated.
+
 - Inform the instrument scientist that you are going to upgrade the instrument in 5 minutes so that they are not surprised when you remote desktop to the instrument, include a link to the release notes of the latest release in this email. Wait 5 minutes.
 - Make sure that `\\isis\shares\ISIS_Experiment_Controls_Public\ibex_utils` is pointing at `master` and is up to date  (i.e. do git pull).
 - Take over the instrument with an RDP session - not VNC.