diff --git a/docs/development/integration.md b/docs/development/integration.md
index 92867b295..527cb3388 100644
--- a/docs/development/integration.md
+++ b/docs/development/integration.md
@@ -83,15 +83,26 @@ On all images, `aa-update` can be used to rebuild and install latest version of
 
 !!! warning
 
-    The following are expected to be run in a [VM](#test-virtual-machines)
+    The test suite is expected to be run in a [VM](#test-virtual-machines)
 
 ### Getting started
 
-Build the test suite
+Prepare the test environment:
 ```sh
-go build ./cmd/aa-test
+cd tests
+make <dist> falvor=<flavor>
+AA_INTEGRATION=true vagrant up <name>
 ```
 
+Run the integration tests on the test VM:
+```sh
+make integration box=<dist> IP=<ip>
+```
+
+### Create integration tests
+
+**Test suite usage**
+
 Initialise the tests with:
 ```sh
 ./aa-test --bootstrap
@@ -107,7 +118,7 @@ Start the tests and collect the results
 ./aa-test --run
 ```
 
-### Create test scenario
+**Tests manifest**
 
 A basic set of test is generated on initialisation. More tests can be manually written in yaml file. They must have the following structure: