diff --git a/README.rst b/README.rst
index 0713bb1..b088d2d 100644
--- a/README.rst
+++ b/README.rst
@@ -1,25 +1,42 @@
 Flask-Logging-Extras
 ====================
 
-[travis button] [coveralls button] [pypi button] [documentation button]
+.. image:: https://travis-ci.org/gergelypolonkai/flask-logging-extras.svg?branch=master
+    :target: https://travis-ci.org/gergelypolonkai/flask-logging-extras
+
+.. image:: https://codecov.io/gh/gergelypolonkai/flask-logging-extras/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/gergelypolonkai/flask-logging-extras
+
+.. image:: https://badge.fury.io/py/Flask-Logging-Extras.svg
+    :target: https://badge.fury.io/py/Flask-Logging-Extras
+
+.. image:: https://readthedocs.org/projects/flask-logging-extras/badge/?version=latest
+    :target: http://flask-logging-extras.readthedocs.io/en/latest/?badge=latest
 
 Flask-Logging-Extras adds additional logging features for Flask applications.
 
 The only feature implemented now is adding extra arguments to the format
-string, like this:
+string, like this (this example adds the category keyword to the logs:
 
 .. code-block:: python
 
    fmt = '[%(asctime)s] [%(levelname)s] [%(category)s] %(message'
    # Initialize log handlers as usual, like creating a FileHandler, and
    # assign fmt to it as a format string
+   app.config['FLASK_LOGGING_EXTRAS_KEYWORDS'] = {'category': '<unset>'}
+   app.logger.init_app(app)
 
    current_app.logger.info('this is the message, as usual',
                            category='fancy-category')
 
-### Installation
+Installation
+------------
 
-pip will be available (hopefully) soon.
+The easiest way to start using the package is with pip:
+
+.. code-block:: sh
+
+   $ pip install Flask-Logging-Extras
 
 If you prefer to install from source, you can clone this repo and run
 
@@ -30,8 +47,8 @@ If you prefer to install from source, you can clone this repo and run
 Usage
 -----
 
-[View the documentation online] (http://flask-jwt-extended.readthedocs.io/en/latest/)
-
+`View the documentation online
+<http://flask-logging-extras.readthedocs.io/>`_
 
 Testing and Code Coverage
 -------------------------
@@ -48,15 +65,18 @@ your local machine, you can simply invoke it with the `tox` command.
 Generating Documentation
 ------------------------
 
-You can generate a local copy of the documentation.  First, make sure you have
-the flask sphinx theme available.  You can get it with
+You can generate a local copy of the documentation.  First, make sure you
+have the flask sphinx theme available.  You can get it (and all possible
+documentation requirements) with
 
 .. code-block:: sh
-   $ pip install Flask-Sphinx-Themes
+
+   $ pip install -r docs-requirements.txt
 
 Then in the `docs/` directory, run
 
 .. code-block:: sh
+
    $ make clean && make html
 
 License