diff --git a/README.md b/README.md
index 49ff085..a8596e6 100644
--- a/README.md
+++ b/README.md
@@ -1,32 +1,50 @@
 # Wormhole: A Cosmos-Substrate bridge
 
 ## What is Wormhole?
-
 Wormhole is a bridge to connect a Substrate-based blockchain to a Cosmos-SDK based blockchain. Specifically it connects
 substrate light client running inside cosmos chain to substrate chain and cosmos light client running inside substrate chain to cosmos chain.
  
 
 ## Parts
-
 The Wormhole bridge, comprises three parts:
   - A fork of Gaia, with an additional module to allow execution of wasm-based light clients.
   - Wormhole, a Substrate-based chain, including a tendermint-client pallet.
   - Quantum-tunnel, a simple relayer, written in rust.
 
 ## Demo
-In order to run the demo, clone this repository, and run `docker-compose up`.
+In order to run the demo, clone this repository, and run following command:
+```
+# Cleans data directory and shuts down any stray docker containers.
+make clean
+
+# Builds docker images, could take a while.
+make build
+
+# Runs a demo
+make run
+```
 
 ## Integration tests
 There are five integration test variants you can run:
-1. **Live**: Both chains are live
-2. **Simulated cosmos**: Cosmos chain is simulated with a text file and headers are fed into cosmos light client running in substrate chain
-3. **Simulated substrate**: Substrate chain is simulated with a text file and headers are fed into substrate light client running in cosmos chain
-4. **Faulty simulated cosmos**: Same as simulated cosmos but with faulty data to test failure scenario
-5. **Faulty simulated substrate**: Same as simulated substrate but with faulty data to test failure scenario
 
+### Live
+Both chains are live. To run this variant you need to execute `make test_live` in project directory.
+Note that this test will not terminate automatically, which provides tester opportunity to check both chain's status.
 
-## Credit and Attribution
+### Simulated cosmos
+Cosmos chain is simulated with a text file and headers are fed into cosmos light client running in substrate chain. To run this variant you need to execute `make test_simulated_cosmos`. If the test is successful, docker compose will exit with zero exit code.
 
+### Simulated substrate
+Substrate chain is simulated with a text file and headers are fed into substrate light client running in cosmos chain. To run this variant you need to execute `make test_simulated_substrate`. If the test is successful, docker compose will exit with zero exit code.
+
+### Faulty simulated cosmos
+Same as simulated cosmos but with faulty data to test failure scenario. To run this variant you need to execute `make test_faulty_simulated_substrate`. If the test is successful, docker compose will exit with zero exit code.
+
+### Faulty simulated substrate
+Same as simulated substrate but with faulty data to test failure scenario. To run this variant you need to execute `make test_faulty_simulated_cosmos`. If the test is successful, docker compose will exit with zero exit code.
+
+
+## Credit and Attribution
 Substrate - Web3 Foundation, Parity
 Cosmos-SDK - All in Bits, Tendermint Inc., Interchain.io, Interchain Foundation
 Cosmwasm - Confio, Ethan Frey and Simon Warta