diff --git a/README.md b/README.md
index b985abf4..0f4b2183 100644
--- a/README.md
+++ b/README.md
@@ -1,38 +1,54 @@
 i2pd
 ====
 
-Independent C++ implementation of I2P router
+i2pd is a full-featured C++ implementation of 
+[I2P](https://geti2p.net/en/about/intro) client.
 
-License
--------
+I2P (Invisible Internet Project) is anonymous network which works on top of 
+public Internet. Privacy and anonymity are achieved by strong encryption and 
+bouncing your traffic through thousands of I2P nodes all around the world.
 
-This project is licensed under the BSD 3-clause license, which can be found in the file
-LICENSE in the root of the project source code.
+We are building network which helps people to communicate and share information 
+without restrictions.
 
-Donations
----------
+* [Website](http://i2pd.website)
+* [Documentation](https://i2pd.readthedocs.io/en/latest/)
+* [Wiki](https://github.com/PurpleI2P/i2pd/wiki)
+* [Tickets/Issues](https://github.com/PurpleI2P/i2pd/issues)
+* [Twitter](https://twitter.com/i2porignal)
 
-BTC: 1K7Ds6KUeR8ya287UC4rYTjvC96vXyZbDY  
-LTC: LKQirrYrDeTuAPnpYq5y7LVKtywfkkHi59  
-ANC: AQJYweYYUqM1nVfLqfoSMpUMfzxvS4Xd7z  
-DOGE: DNXLQKziRPAsD9H3DFNjk4fLQrdaSX893Y 
+Installing
+----------
 
-Documentation:
---------------
-http://i2pd.readthedocs.org
+The easiest way to install i2pd is by using 
+[precompiled binaries](https://github.com/PurpleI2P/i2pd/releases/latest). 
+See [documentation](https://i2pd.readthedocs.io/en/latest/) for how to build 
+i2pd from source on your OS.
 
-Supported OS
-------------
+**Supported systems:**
 
 * Linux x86/x64  - [![Build Status](https://travis-ci.org/PurpleI2P/i2pd.svg?branch=openssl)](https://travis-ci.org/PurpleI2P/i2pd)  
 * Windows        - [![Build status](https://ci.appveyor.com/api/projects/status/1908qe4p48ff1x23?svg=true)](https://ci.appveyor.com/project/PurpleI2P/i2pd)  
 * Mac OS X
 * FreeBSD
+* Android *(coming soon)*
+
+Using i2pd
+----------
+
+See [documentation](https://i2pd.readthedocs.io/en/latest/) and 
+[example config file](https://github.com/PurpleI2P/i2pd/blob/openssl/docs/i2pd.conf).
 
-More documentation
-------------------
+Donations
+---------
+
+BTC: 1K7Ds6KUeR8ya287UC4rYTjvC96vXyZbDY  
+LTC: LKQirrYrDeTuAPnpYq5y7LVKtywfkkHi59  
+ANC: AQJYweYYUqM1nVfLqfoSMpUMfzxvS4Xd7z  
+DOGE: DNXLQKziRPAsD9H3DFNjk4fLQrdaSX893Y 
+
+License
+-------
 
-* [Building from source / unix](docs/build_notes_unix.md)  
-* [Building from source / windows](docs/build_notes_windows.md)  
-* [Configuring your i2pd](docs/configuration.md)  
-* [Github wiki](https://github.com/PurpleI2P/i2pd/wiki/)  
+This project is licensed under the BSD 3-clause license, which can be found in the file
+LICENSE in the root of the project source code.
diff --git a/docs/index.rst b/docs/index.rst
index 3963dc3c..d0471add 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,20 +1,27 @@
 i2pd
 ====
 
-`Website <http://i2pd.website>`_ | 
-`Github <https://github.com/PurpleI2P/i2pd>`_ |
-`Issues <https://github.com/PurpleI2P/i2pd/issues>`_
+i2pd is a full-featured C++ implementation of 
+`I2P <https://geti2p.net/en/about/intro>`_ client.
 
-i2pd is C++ implementation of `I2P <https://geti2p.net/en/about/intro>`_.
+* `Website <http://i2pd.website>`_
+* `GitHub <https://github.com/PurpleI2P/i2pd>`_
+* `Wiki <https://github.com/PurpleI2P/i2pd/wiki>`_
+* `Tickets/Issues <https://github.com/PurpleI2P/i2pd/issues>`_
+* `Twitter <https://twitter.com/i2porignal>`_
 
-Supports:                                                                       
----------
-                                                                                
-* Complete I2P router functionality                                             
-* Floodfill                                                                     
-* HTTP and SOCKS proxy                                                          
-* I2P client and server tunnels                                                 
-* SAM and BOB interfaces
+Installing
+----------
+
+The easiest way to install i2pd is by using 
+`precompiled binaries <https://github.com/PurpleI2P/i2pd/releases/latest>`_. 
+See documentation for how to build i2pd from source on your OS.
+
+Using i2pd
+----------
+
+See documentation and 
+`example config file <https://github.com/PurpleI2P/i2pd/blob/openssl/docs/i2pd.conf>`_.
 
 Contents:
 ---------
@@ -28,3 +35,4 @@ Contents:
    configuration
    family
 
+