More informative README and docs index

README.md

@@ -1,13 +1,43 @@
 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
+We are building network which helps people to communicate and share information 
-LICENSE in the root of the project source code.
+without restrictions.
+
+* [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)
+
+Installing
+----------
+
+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 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).
 
 Donations
 ---------
@@ -17,22 +47,8 @@ LTC: LKQirrYrDeTuAPnpYq5y7LVKtywfkkHi59
 ANC: AQJYweYYUqM1nVfLqfoSMpUMfzxvS4Xd7z  
 DOGE: DNXLQKziRPAsD9H3DFNjk4fLQrdaSX893Y 
 
-Documentation:
+License
---------------
+-------
-http://i2pd.readthedocs.org
 
-Supported OS
+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.
-
-* 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
-
-More documentation
-------------------
-
-* [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/)  

docs/index.rst

@@ -1,20 +1,27 @@
 i2pd
 ====
 
-`Website <http://i2pd.website>`_ | 
+i2pd is a full-featured C++ implementation of 
-`Github <https://github.com/PurpleI2P/i2pd>`_ |
+`I2P <https://geti2p.net/en/about/intro>`_ client.
-`Issues <https://github.com/PurpleI2P/i2pd/issues>`_
 
-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:                                                                       
+Installing
----------
+----------
-                                                                                
+
-* Complete I2P router functionality                                             
+The easiest way to install i2pd is by using 
-* Floodfill                                                                     
+`precompiled binaries <https://github.com/PurpleI2P/i2pd/releases/latest>`_. 
-* HTTP and SOCKS proxy                                                          
+See documentation for how to build i2pd from source on your OS.
-* I2P client and server tunnels                                                 
+
-* SAM and BOB interfaces
+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
 
+