diff --git a/README.md b/README.md
index 1d2b8e3..b4e3113 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,34 @@
-# OpenAire Graph Beginner's Kit
+# OpenAIRE Graph Beginner's Kit
 
-# prerequisite
-
-Install docker
-
-# how to build
-
-`docker build --rm  -t  openaire-beginners-kit .`
-
-# how to run
-
-`docker run -p 8888:8888  --rm  openaire-beginners-kit`
+This beginner's kit runs entirely in a Docker container so as to minimise the effort required to get started and the amount of software packages and frameworks to be installed.
+Docker Engine is the only piece of software required.
 
 
+# Prerequisites
+Install Docker Engine from https://www.docker.com
+
+
+# How to build
+First, `git clone` this repository, then open a Terminal window and get inside the cloned folder.
+
+Once you are in position, run the following command
+
+```docker build --rm  -t  openaire-beginners-kit .```
+
+This will take care of everything is needed to create a Docker image. At the end, you will have an environment with Python, Jupyter notebooks, Pandas, Spark and another bunch of modules installed. Easy peasy.
+
+
+# How to run the container
+Open Docker Engine, locate the Docker image you just built and run it, having care of specifying a port (e.g., 8888).
+In the log, you should see an URL promped like `https://127.0.0.1:8888/...`; that's our guy, click on it.
+The browser will open a page with JupyterLab; this is where you can start playing with the OpenAIRE Graph.
+
+You can run the container from the Terminal too with the following command
+
+```docker run -p 8888:8888  --rm  openaire-beginners-kit```
+
+
+# How to fetch the data
+Follow the instructions reported in the notebook.