diff --git a/README.md b/README.md
index 661abb0..c95ffc5 100644
--- a/README.md
+++ b/README.md
@@ -1,39 +1,40 @@
 # Jenkins jobs configuration
 
 This repository manages the jenkins jobs configuration.
 
 A [jenkins jobs] applies the configuration on jenkins when a commit is done in this repository
 
 [jenkins jobs]: https://jenkins.softwareheritage.org/job/jenkins-tools/job/swh-jenkins-job-builder
 
 
 # Testing
 
 To test locally the configuration , simply run ``tox``:
 
 ```
 tox
 ```
 
 The output displays the jenkins configuration files as they will be applied on the server.
 
 # Run on docker
 
-TODO improve this part
-
-- launch jenkins
+- Launch jenkins
 ```
 docker-compose build
 docker-compose up
 ```
-- get the admin password in the logs
-- connect to localhost:8080
-- change the admin password to `admin123`
-- create a jenkins directory `jenkins-tools`
-- create a new free-style job named `job-builder` inside the `jenkins-tools` pointing this git repository
-  - configure the right branch (ci here)
-  - Add a step `Execute a script shell` with this content
+- Get the admin password in the logs
+
+Connect to localhost:8080, then within the jenkins ui:
+- Change the `admin` password to `admin123`
+- Create a jenkins folder `jenkins-tools`
+- Create a new `free-style` job named `job-builder` inside the `jenkins-tools` targeting
+  this git repository `https://forge.softwareheritage.org/source/swh-jenkins-jobs.git`
+  - Configure the branch (e.g. `*/master`)
+  - Add a `build` step `Execute shell` with this content
 ```
 tox update -- --delete-old
 ```
-- save and launch \o/
+- Save your build configuration
+- Trigger a build \o/