Edit rst style of README
+`BinderHub`_
+============
+
What is BinderHub?
--------------------
-BinderHub allows you to BUILD and REGISTER a Docker image using a GitHub
-repository along with a branch name / commit / tag. It also connects with
+------------------
+
+**BinderHub** allows you to ``BUILD`` and ``REGISTER`` a Docker image using a
+GitHub repository along with a branch name / commit / tag. It also connects with
JupyterHub, allowing you to create a public IP address that allows users to
interact with the code / environment you specify in the repository within
a live JupyterHub instance.
It is similar in spirit to the existing `Binder <http://mybinder.org>`_ service.
-It's goal is to tie together:
+Its goal is to tie together:
- `JupyterHub <https://github.com/jupyterhub/jupyterhub>`_ to provide
a scalable system for authenticating users and spawning single user
@@ -20,7 +24,8 @@ BinderHub is created using Python, kubernetes, tornado, and traitlets. As such,
it should be a familiar technical foundation for Jupyter developers.
Why BinderHub?
----------------
+--------------
+
Collections of Jupyter notebooks are becoming more common in scientific research
and data science. The ability to serve these collections on demand enhances the
usefulness of these notebooks.
@@ -28,16 +33,20 @@ usefulness of these notebooks.
Installation
------------
-**BinderHub** is based on Python 3, and it can be installed using pip::
+**BinderHub** is based on Python 3, and it can be installed using ``pip``::
pip install binderhub
Documentation
-------------
+
For more information about the architecture, use, and setup of BinderHub, see
-`the online documentation <https://jupyterhub.github.io/binderhub>`_.
+`the documentation online <https://jupyterhub.github.io/binderhub>`_ or on
+`ReadTheDocs <https://binderhub.readthedocs.io>`.
License
-------
-See `LICENSE` file in this repository.
+See ``LICENSE`` file in this repository.
+
+.. _BinderHub: https://github.com/jupyterhub/binderhub
