Rewrite README

README.rst

@@ -0,0 +1,68 @@
+=======
+marbles
+=======
+
+.. image:: https://img.shields.io/pypi/v/marbles.svg
+        :target: https://pypi.python.org/pypi/marbles
+
+.. image:: https://img.shields.io/travis/twosigma/marbles.svg
+        :target: https://travis-ci.org/twosigma/marbles
+
+.. image:: https://readthedocs.org/projects/marbles/badge/?version=latest
+        :target: https://marbles.readthedocs.io/en/latest/?badge=latest
+        :alt: Documentation Status
+
+.. image:: https://pyup.io/repos/github/twosigma/marbles/shield.svg
+        :target: https://pyup.io/repos/github/twosigma/marbles/
+        :alt: Updates
+
+Read better test failures.
+
+* Free software: MIT license
+* Documentation: https://marbles.readthedocs.io.
+
+Overview
+--------
+
+`marbles` is a Python `unittest` extension that allows test authors to write
+richer tests that expose more information on test failure to help you debug
+failing tests faster.
+
+* Treat test failures as documentation
+* Contextualize failures without digging through test code
+  and dropping debugging statements everywhere
+* Write clearer, more explicit tests
+
+Features
+--------
+
+* Drop-in `unittest` replacement
+* Information-rich failure messages
+
+  * The full statement that failed (instead of just the last line)
+  * Local variables in scope at the time the test failed
+  * Optional annotation provided by the test author with details about the test
+  * Ability to toggle traceback
+
+* Semantically-rich assertion methods
+
+Demo
+----
+
+You can run the example tests provided to see what a `marbles` failure message
+looks like
+
+.. include:: docs/examples/getting_started.txt
+
+You can also run your existing `unittest` tests with `marbles` in two steps
+
+.. code-block:: bash
+
+   python -m marbles test_module.py
+
+Installing
+----------
+
+.. code-block:: bash
+
+   pip install marbles