README.txt -> README.rst

README.rst

@@ -7,8 +7,8 b' Overview'
 
 Welcome to IPython. Our full documentation can be found in the ``docs/dist``
 subdirectory in ``.html`` and ``.pdf`` formats, also available online at our
-`website <http://ipython.scipy.org>`_.  The ``docs/source`` directory contains
-the plaintext version of these manuals.
+`docs repo <http://ipython.github.com/ipython-doc>`_.  The ``docs/source`` directory 
+contains the plaintext version of these manuals.
 
 
 Dependencies and supported Python versions
@@ -19,7 +19,7 b' of IPython only need the Python standard library, but much of its more advanced'
 functionality requires extra packages.
 
 Officially, IPython requires Python version 2.6 or 2.7.  An experimental port
-of IPython to Python 3.x has been sarted, and is available at
+of IPython to Python 3.x has been started, and is available at
 http://github.com/takowl/ipython/tree/ipython-py3k.
 
     
@@ -27,9 +27,7 b' Instant running'
 ===============
 
 You can run IPython from this directory without even installing it system-wide
-by typing at the terminal:
+by typing at the terminal::
 
-.. code-block:: bash
-
-   python ipython.py
+   $ python ipython.py