From 7f87b69bf710e4cec75459ba196f8f83e8f22cb0 Mon Sep 17 00:00:00 2001
From: Alexandre Pujol <alexandre@pujol.io>
Date: Tue, 19 Sep 2023 19:48:02 +0100
Subject: [PATCH] doc: update integration test page.

---
 docs/development/integration.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/development/integration.md b/docs/development/integration.md
index 92867b29..527cb338 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: