Merge pull request #301 from willingc/update-read

Update README and add @captainsafia suggestions

Author: willingc

README.md

@@ -1,15 +1,23 @@
 # Interactive HTML Widgets
 
-[![Build Status](https://travis-ci.org/ipython/ipywidgets.svg?branch=master)](https://travis-ci.org/ipython/ipywidgets) [![Join the chat at https://gitter.im/ipython/ipywidgets](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ipython/ipywidgets?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/#!forum/jupyter)
+[![Build Status](https://travis-ci.org/ipython/ipywidgets.svg?branch=master)](https://travis-ci.org/ipython/ipywidgets)
+[![Documentation Status](https://readthedocs.org/projects/ipywidgets/badge/?version=latest)](http://ipywidgets.readthedocs.org/en/latest/?badge=latest)
+[![Join the chat at https://gitter.im/ipython/ipywidgets](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ipython/ipywidgets?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-[Interactive HTML widgets](https://github.com/ipython/ipywidgets/blob/master/examples/notebooks/Index.ipynb) for Jupyter notebooks and the IPython kernel.
+[Interactive HTML widgets](https://github.com/ipython/ipywidgets/blob/master/examples/notebooks/Index.ipynb)
+for Jupyter notebooks and the IPython kernel.
+
+A [demonstration notebook](https://github.com/ipython/ipywidgets/blob/master/examples/notebooks/Index.ipynb) provides an overview of the interactive widgets. For detailed information, please refer to the [ipywidgets documentation](http://ipywidgets.readthedocs.org/en/latest/).
 
 ## Install
 
-You can install the current version of ipywidgets with pip or conda:
+Install the current version of ipywidgets using pip or conda:
 
     pip install ipywidgets
-    # or
+
+or
+
     conda install ipywidgets
 
 
@@ -26,8 +34,8 @@ To install ipywidgets from git, you will need [npm](https://www.npmjs.com/).
 
         pip install -v -e .
 
-    Note: You need to have npm installed.  The installation process will 
-    complain if you don't.  If you install using sudo, you need to make sure 
+    Note: You need to have npm installed.  The installation process will
+    complain if you don't.  If you install using sudo, you need to make sure
     that npm is also available in the PATH used with sudo.
 
 
@@ -41,4 +49,16 @@ To run the Javascript tests:
 
     npm run test
 
-This will run the test suit using `karma` with 'debug' level logging.
+This will run the test suite using `karma` with 'debug' level logging.
+
+## Resources
+### ipywidgets
+- [Demo notebook of interactive widgets](https://github.com/ipython/ipywidgets/blob/master/examples/notebooks/Index.ipynb)
+- [Documentation for ipywidgets](http://ipywidgets.readthedocs.org/en/latest/) [[PDF](https://media.readthedocs.org/pdf/ipywidgets/latest/ipywidgets.pdf)]
+- [Issues](https://github.com/ipython/ipywidgets/issues)
+- [Technical support - Jupyter Google Group](https://groups.google.com/forum/#!forum/jupyter)
+
+### Project Jupyter
+- [Project Jupyter website](https://jupyter.org)
+- [Online Demo of Jupyter Notebook at try.jupyter.org](https://try.jupyter.org)
+- [Documentation for Project Jupyter](http://jupyter.readthedocs.org/en/latest/index.html) [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]