From 9112ad0f4a7061ab1c6ddb68f4ea162aeba3d307 Mon Sep 17 00:00:00 2001
From: Gopalakrishna Palem <KrishnaPG@Yahoo.com>
Date: Sat, 30 May 2015 08:34:16 +0530
Subject: [PATCH] Added note about pip3 and zmq

Updated Readme.md with optional dependencies
---
 README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/README.md b/README.md
index 89f66651..7121a8a4 100644
--- a/README.md
+++ b/README.md
@@ -33,9 +33,34 @@ Then install javascript dependencies:
 
     sudo npm install -g configurable-http-proxy
 
+### Optional
+
+- A note on `pip` command used in the below installation sections is worth mentioning. Given that JupyterHub now requires Python >= 3.3 it may be required on some machines to use `pip3` instead of `pip` (especially when you have both Python 2 and Python 3 installed on your machine). 
+If `pip3` is not found on your machine, you can get it by doing:
+````
+    sudo apt-get install python3-pip
+````
+- If you see JupyterHub complaining about `zmq not found` error, resolve it by doing:
+````
+    sudo apt-get install python3.4-dev
+    sudo pip3 install zmq
+````
+- If you see JupyterHub complaining about `jsonSchema` missing, resolve it by doing:
+````
+    sudo pip3 install jsonschema
+````
+- If you are not seeing `Terminal` option in the notebooks, you can enable it by doing:
+````
+    sudo pip3 install terminado
+````
 
 ## Installation
 
+As usual start with cloning the code:
+
+    git clone https://github.com/jupyter/jupyterhub.git
+    cd jupyterhub
+
 Then you can install the Python package by doing:
 
     pip install -r requirements.txt