From 5be147e8ccb9d22edf2acc30dde25cc1d1d3b6ed Mon Sep 17 00:00:00 2001
From: libre-net-society <l-n-s@sigaint.org>
Date: Thu, 16 Jun 2016 01:11:42 +0300
Subject: [PATCH] More informative README and docs index

---
 README.md      | 62 +++++++++++++++++++++++++++++++-------------------
 docs/index.rst | 32 ++++++++++++++++----------
 2 files changed, 59 insertions(+), 35 deletions(-)

diff --git a/README.md b/README.md
index b985abf4..0f4b2183 100644
--- a/README.md
+++ b/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
-LICENSE in the root of the project source code.
+We are building network which helps people to communicate and share information 
+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:
---------------
-http://i2pd.readthedocs.org
+License
+-------
 
-Supported OS
-------------
-
-* 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/)  
+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
 
+