Improve RS tut

docs/tutorials/retroshare.md

@@ -1,21 +1,27 @@
 Using RetroShare with i2pd
 ==========================
 
+RetroShare is a rich set of P2P applications, which can work on top of anonymous I2P network.
+Quoting [Wikipedia](https://en.wikipedia.org/wiki/RetroShare):
 
-Retroshare is I2P capable.  
+> RetroShare is open source software for encrypted filesharing, serverless email, instant messaging, online chat, and BBS, based on a friend-to-friend network built on GNU Privacy Guard (GPG).
-Their [configuration instructions](https://retroshare.readthedocs.io/en/latest/tutorial/i2p-hidden-rs-node/) for Java I2P.
-In order to do it for i2pd, you must create a new server tunnels in tunnels.conf like this  
 
-[Retroshare]  
+In order to make RetroShare work with i2pd, you need to create a new server tunnel in [tunnels.conf](../user-guide/tunnels.md) like this: 
+
+    [retroshare]  
     type=server  
     host=127.0.0.1  
-port="port you wish to use"  
+    port=10123            # pick random port of your choice 
     keys=retroshare.dat  
 
-You can specify [more options](https://github.com/PurpleI2P/i2pd/wiki/tunnels.conf)  
+Make sure that Socks proxy is enabled, it listens at ``127.0.0.1:4447`` by default. If not, look at [i2pd.conf documentation](../user-guide/configuration.md).
-Also keep SOCKS proxy enabled. It's enabled by default.
+
+Restart i2pd with new configuration. 
+
+Find .b32.i2p address of your RetroShare node.
+Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \<long random string\>.b32.i2p next to "retroshare".
 
-Start i2pd with this new tunnels, and get it's .b32.i2p address from http://127.0.0.1:7070/?page=i2p_tunnels.
+Now when everything is prepared, you can run RetroShare itself and create a new profile.
-Now you are ready to create hidden profile for Retroshare.
+Mark it as **hidden** and enter your **.b32.i2p address** and **port** you have specified at tunnels.conf.
-Mark it as hidden and enter your .b32.i2p and port you specified for tunnel.
 
+More information about RetroShare at their [website](http://retroshare.net).