X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=README.md;h=5d4261d6e71f852f38eb318974d709f8646569a1;hb=f9b6f0e202eb6fa3f87a6ce309b9091569f43615;hp=63cece5688bbbbdb80613c5b2402ea9ab8eb6e38;hpb=9354db3aa7572bf371a7ef6dfe37eebc4e8eaf33;p=plcapi.git

diff --git a/README.md b/README.md
index 63cece5..5d4261d 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,28 @@ If you are upgrading from version 3 or earlier you have two options:
 In any case, read carefully the docs in [doc/api_changes_v4.md](doc/api_changes_v4.md) and report back any undocumented
 issue using GitHub.
 
+Running tests
+-------------
+
+The recommended way to run the library test suite is via the provided Docker containers.
+A handy shell script is available that simplifies usage of Docker.
+
+The full sequence of operations is:
+
+    ./tests/ci/vm.sh build
+    ./tests/ci/vm.sh start
+    ./tests/ci/vm.sh runtests
+    ./tests/ci/vm.sh stop
+
+    # and, once you have finished all testing related work:
+    ./tests/ci/vm.sh cleanup
+
+By default tests are run using php 7.0 in a Container based on Ubuntu 16 Xenial.
+You can change the version of PHP and Ubuntu in use by setting the environment variables PHP_VERSION and UBUNTU_VERSION
+before building the Container.
+
+To generate the code-coverage report, run `./tests/ci/vm.sh runcoverage`
+
 License
 -------
 Use of this software is subject to the terms in the [license.txt](license.txt) file