Fixed mkdocs version and a small fix

Author: Nathan Speidel

README.md

@@ -6,26 +6,24 @@ The built documentation can be accessed [here](https://yahoo.github.io/bullet-do
 
 ## Building the documentation
 
-You need [mkdocs](http://www.mkdocs.org/#installation) installed to build the documentation.
-
-This also uses the mkdocs theme : [Cinder](http://sourcefoundry.org/cinder/).
-
-Since Cinder has not been upgraded in a while, you will need to bring in changes in this [PR](https://github.com/chrissimpkins/cinder/pull/26) of Cinder found here: [twardoch/clinker-mktheme](https://github.com/twardoch/clinker-mktheme/tree/2016-12-22)
-and add on this fix in this [PR](https://github.com/twardoch/clinker-mktheme/pull/10)
-
-You will also need Python installed.
+You will need Python installed.
 
 ```bash
 sudo pip install virtualenv
 virtualenv mkdocs
 source mkdocs/bin/activate
+pip install mkdocs==0.16.3 
 pip install mkdocs-cinder
-pip install git+git://github.com/twardoch/clinker-mktheme.git@2016-12-22 --upgrade
+pip install git+git://github.com/twardoch/clinker-mktheme.git@master --upgrade
 git clone git@github.com:yahoo/bullet-docs.git
 cd bullet-docs
-mkdocs build
+mkdocs serve
 ```
 
+The above commands will install [mkdocs](http://www.mkdocs.org/#installation) along with the mkdocs theme : [Cinder](http://sourcefoundry.org/cinder/).
+
+Since Cinder has not been upgraded in a while, it uses the changes in this [PR](https://github.com/chrissimpkins/cinder/pull/26) of Cinder found here: [twardoch/clinker-mktheme](https://github.com/twardoch/clinker-mktheme/tree/master).
+
 ## Building the examples
 
 You will need [Maven 3](https://maven.apache.org/install.html) and [JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/index.html) installed to build the examples.

docs/quick-start.md

@@ -75,6 +75,8 @@ storm logviewer &
 storm supervisor &
 ```
 
+It may take 30-60 seconds for all the components to launch.
+
 Once everything is up without errors, visit [http://localhost:8080](http://localhost:8080) and see if the Storm UI loads.
 
 #### Step 4: Test Storm (Optional)