diff --git a/tutorial/1-6-setup-erlang-environmnet.md b/tutorial/1-6-setup-erlang-environmnet.md
index 11e65a49a5e2012a40cb18ab64f678009bdba1f1..2d1519a6f3dc0e4bb686bfa107c0ca5b16eb6cd2 100644
--- a/tutorial/1-6-setup-erlang-environmnet.md
+++ b/tutorial/1-6-setup-erlang-environmnet.md
@@ -1,6 +1,9 @@
 # 1.5. Setup Erlang Environment
 
-First we need to install Erlang. There is multiple way, for development we will be using asdf.
+First we need to install Erlang. There is multiple way, for development we will
+be using *ASDF*, a tool that allows the installation of multiple version of Erlang
+at the same time, and switch from one version to the other at will.
+
 
 ## 1.5.1. Setup Erlang using asdf
 
@@ -8,31 +11,36 @@ First, install any missing dependencies:
 
     sudo apt install curl git autoconf libncurses-dev build-essential m4 libssl-dev 
 
-Download asdf:
+Download *ASDF* tool to the local account:
 
     git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.10.2
 
-Make asdf activate on login by adding these lines at the end of the `~/.bashrc` file:
+Make *ASDF* activate on login by adding these lines at the end of the `~/.bashrc` file:
 
     . $HOME/.asdf/asdf.sh
     . $HOME/.asdf/completions/asdf.bash
 
-Logout and log back in to activate asdf.
+Logout and log back in to activate *ASDF*.
 
-Install asdf plugin for Erlang:
+*ASDF* supports multiple tools by installing there corresponding plugins.
+Install *ASDF* plugin for Erlang:
 
     asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git
 
-Install Erlang:
+Install a version of Erlang:
 
     asdf install erlang 24.3.4.2
 
-Activate Erlang locally for TFS controller:
+Activate Erlang locally for TFS controller. This will create a local file
+called `.tool-versions` defining which version of the tools to use when
+running under the current directory:
 
     cd tfs-ctrl/
     asdf local erlang 24.3.4.2
 
-Install rebar3:
+Erlang projects uses a build tool called rebar3. It is used to manager project
+dependenecies, compile a project and generate project releases.
+Install rebar3 localy from source:
 
     cd ~
     git clone https://github.com/erlang/rebar3.git
diff --git a/tutorial/2-6-te-demo.md b/tutorial/2-6-te-demo.md
index 9bfd7881c716ca4589e948aee76a74b05357f1a3..778d62e06769782f170aab2adad7a09f218eab47 100644
--- a/tutorial/2-6-te-demo.md
+++ b/tutorial/2-6-te-demo.md
@@ -1,4 +1,4 @@
-# 2.6. Traffic Engineering Demo (PENDING)
+# 2.6. Traffic Engineering Demo (WIP)
 
 ## Setup Test-Bed
 
@@ -20,7 +20,7 @@
 ### Setup Free Range Routing
 
     $ sudo apt update
-    $ sudo apt-get install git autoconf automake libtool make libreadline-dev texinfo    pkg-config libpam0g-dev libjson-c-dev bison flex libc-ares-dev python3-dev python3-sphinx install-info build-essential libsnmp-dev perl libcap-dev python2 libelf-dev libunwind-dev protobuf-c-compiler libprotobuf-c-dev libsystemd-dev
+    $ sudo apt-get install git autoconf automake libtool make libreadline-dev texinfo pkg-config libpam0g-dev libjson-c-dev bison flex libc-ares-dev python3-dev python3-sphinx install-info build-essential libsnmp-dev perl libcap-dev python2 libelf-dev libunwind-dev protobuf-c-compiler libprotobuf-c-dev libsystemd-dev
     $ mkdir -p ~/testbed
     $ cd ~/testbed
     $ git clone git@github.com:opensourcerouting/frr.git