Updated README

Author: pawelad

README.md

@@ -1,25 +1,25 @@
 # python-ivona-api
-[![Build Status](https://img.shields.io/travis/Pythonity/python-ivona-api.svg)][ivona api travis]
-[![PyPI Version](https://img.shields.io/pypi/v/ivona_api.svg)][ivona api pypi]
-[![Python Versions](https://img.shields.io/pypi/pyversions/ivona_api.svg)][ivona api pypi]
+[![Build Status](https://img.shields.io/travis/Pythonity/python-ivona-api.svg)][travis]
+[![PyPI Version](https://img.shields.io/pypi/v/ivona_api.svg)][pypi]
+[![Python Versions](https://img.shields.io/pypi/pyversions/ivona_api.svg)][pypi]
 [![License](https://img.shields.io/github/license/Pythonity/python-ivona-api.svg)][license]
 
-Python (3) library that helps you connect to Amazon's [IVONA][ivona]
-Speech Cloud from within your Python project. You need its
-[access keys][ivona keys] to use it.
+Python library that helps you connect to Amazon's [IVONA][ivona] Speech Cloud
+from within your Python project. All you need to use it are the
+[access keys][ivona keys].
 
 It currently only implements `CreateSpeech` and `ListVoices` endpoints,
 as they should cover the vast majority of use cases. Lexicons endpoints
 may be added in the future.
 
 If you're looking for out-of-the-box solution, have a look at 
-[ivona-speak][ivona speak github] - it's a script that uses this very
+[ivona-speak][ivona speak] - it's a script that uses this very
 library and lets you use its functionality directly from your shell.
 
 ## Installation
-With `PyPI`:
+With PyPI:
 ```
-$ pip3 install ivona_api
+$ pip install ivona_api
 ```
 
 ## API
@@ -30,33 +30,35 @@ But feel free to ask [me](mailto:pawel.adamczak@sidnet.info) if anything
 is unclear.
 
 ## Tests
-Package was tested with `pytest` and `tox` on Python 3.4
-(see `tox.ini`).
+Package was tested with the help of `py.test` and `tox` on Python 2.7, 3.4
+and 3.5 (see `tox.ini`).
 
 To run tests yourself you need to set environment variables with secret
-and access keys before running `tox` inside the repository:
+and access keys before running `tox`:
 ```shell
-export IVONA_ACCESS_KEY="YOUR_ACTUAL_ACCESS_KEY"
-export IVONA_SECRET_KEY="YOUR_ACTUAL_SECRET_KEY"
+$ export IVONA_ACCESS_KEY="YOUR_ACTUAL_ACCESS_KEY"
+$ export IVONA_SECRET_KEY="YOUR_ACTUAL_SECRET_KEY"
+$ tox
 ```
 
 ## Contributions
-Package source code is available at [GitHub][ivona api github].
+Package source code is available at [GitHub][github].
 
-Feel free to use, ask, fork, star, report bugs, fix them, suggest 
-enhancements and point out any mistakes.
+Feel free to use, ask, fork, star, report bugs, fix them, suggest enhancements,
+add functionality and point out any mistakes.
 
 ## Authors
 Developed and maintained by [Pythonity][pythonity].
 
 Written by [Paweł Adamczak][pawelad].
 
-[ivona api travis]: https://travis-ci.org/Pythonity/python-ivona-api
-[ivona api github]: https://github.com/Pythonity/python-ivona-api
-[ivona api pypi]: https://pypi.python.org/pypi/ivona_api
-[license]: https://github.com/Pythonity/python-ivona-api/blob/master/LICENSE
-[ivona]: https://www.ivona.com/
+
+[github]: https://github.com/Pythonity/python-ivona-api
 [ivona keys]: http://developer.ivona.com/en/speechcloud/introduction.html#Credentials
-[ivona speak github]: https://github.com/Pythonity/ivona-speak
+[ivona speak]: https://github.com/Pythonity/ivona-speak
+[ivona]: https://www.ivona.com/
+[license]: https://github.com/Pythonity/python-ivona-api/blob/master/LICENSE
+[pawelad]: https://github.com/pawelad
 [pythonity]: http://pythonity.com/
-[pawelad]: https://github.com/pawelad
+[travis]: https://travis-ci.org/Pythonity/python-ivona-api
+[ypi]: https://pypi.python.org/pypi/ivona_api