diff --git a/docs/index.html b/docs/index.html
index 5d3725e7..e8818f30 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -99,7 +99,6 @@ class: title
 Docker <br/> Orchestration <br/> Workshop
 
 ???
----
 
 ## Intros
 
@@ -108,7 +107,7 @@ Docker <br/> Orchestration <br/> Workshop
   &
   Jérôme ([@jpetazzo](https://twitter.com/jpetazzo))
 
---
+???--
 
 - This is our collective Docker knowledge:
 
@@ -123,7 +122,6 @@ at e.g. 9am, and start at 9:30.
 -->
 
 ???
----
 
 ## Agenda
 
@@ -165,6 +163,49 @@ Remember to change:
 
 ---
 
+## A brief introduction
+
+- This was initially written to support in-person,
+  instructor-led workshops and tutorials
+
+- You can also follow along on your own, at your own pace
+
+- We included as much information as possible in these slides
+
+- We recommend having a mentor to help you ...
+
+- ... Or be comfortable spending some time reading the Docker
+ [documentation](https://docs.docker.com/) ...
+
+- ... And looking for answers in the [Docker forums](forums.docker.com),
+  [StackOverflow](http://stackoverflow.com/questions/tagged/docker),
+  and other outlets
+
+---
+
+## Hands on, you shall practice
+
+- Nobody ever became a Jedi by spending their lives reading Wookiepedia
+
+- Likewise, it will take more than merely *reading* these slides
+  to make you an expert
+
+- These slides include *tons* of exercises
+
+- They assume that you have access to a cluster of Docker nodes
+
+- If you are attending a workshop or tutorial:
+  <br/>you will be given specific instructions to access your cluster
+
+- If you are doing this on your own:
+  <br/>you can use
+  [Play-With-Docker](http://www.play-with-docker.com/) and
+  read [these instructions](https://github.com/jpetazzo/orchestration-workshop#using-play-with-docker) for extra
+  details
+
+???
+---
+
 <!--
 grep '^# ' index.html | grep -v '<br' | tr '#' '-'
 -->
@@ -3440,8 +3481,9 @@ A few solutions, by increasing order of flexibility:
   - example: [user and permission management] in [UCP]
 
 [authorization plugins]: https://docs.docker.com/engine/extend/plugins_authorization/
-[UCP]: https://docs.docker.com/datacenter/ucp/2.0/guides/
-[user and permission management]: https://docs.docker.com/datacenter/ucp/2.0/guides/user-management/
+[UCP]: https://docs.docker.com/datacenter/ucp/2.1/guides/
+[user and permission management]: https://docs.docker.com/datacenter/ucp/2.1/guides/admin/manage-users/
+
 
 ---