Improve documentation

Author: ggarri

README.md

@@ -11,37 +11,42 @@ other users.
 
 ## Features
 
-**Create an account**
-![Signup](docs/imgs/signup.png?raw=true)
+### Create an account
 
-**Login**
-![Login](docs/imgs/login.png?raw=true)
+![Signup](/assets/signup.png?raw=true)
 
-**Your user wallet**
-![Signup](docs/imgs/wallet.png?raw=true)
+### Login
 
-**Upload file**
-![Upload file](docs/imgs/upload_file.png?raw=true)
+![Login](/assets/login.png?raw=true)
 
-**My files**
-![My Files](docs/imgs/my_files.png?raw=true)
+### Your user wallet
+
+![Signup](/assets/wallet.png?raw=true)
+
+#### Upload file
+
+![Upload file](/assets/upload_file.png?raw=true)
+
+#### My files
+
+![My Files](/assets/my_files.png?raw=true)
 You can see the list of files you uploaded and which users have access to them. By clicking
 on one of the little icon you can revoke the access to the users at anytime.
 
 Also you can download the content of the files you uploaded.
 
-**Grant access to file**
-![Grant access to file](docs/imgs/grant_access.png?raw=true)
+### Grant access to file
+![Grant access to file](/assets/grant_access.png?raw=true)
 Grant access to other users to your content without waiting for a access request.
 
-**Request access to other user file**
-![Pending request](docs/imgs/pending_requests.png?raw=true)
+### Request access to other user file
+![Pending request](/assets/pending_requests.png?raw=true)
 Insert the username of other user and load the list of available items of this user.
 By clicking on the locker icon you will send a access request to the file owner. In case
 you already got access to the file it will display the download action.
 
-**Request access to other user file**
-![Request file access](docs/imgs/request_file_access.png?raw=true)
+### Request access to other user file
+![Request file access](/assets/request_file_access.png?raw=true)
 On this section it will listed the pending access requests from other users to your files.
 
 
@@ -54,18 +59,18 @@ The first of them is what it was called stake holder account. This account
  is linked to every instance of the server application and it is funding the creation
  of new users through its own endpoints.
 
- The second funding source is an Faucet smart contract which will fund
+ The second funding source is an Faucet smart contract [0xdf81615E44b34C7015bF148De30526A4863c0DcD](https://explorer.sirius.lightstreams.io/addr/0xdf81615e44b34c7015bf148de30526a4863c0dcd) which will fund
  the activity of users up to 10 PHTs. This smart contract can be top up by every entity
- interested in the growth of the project [0xdf81615E44b34C7015bF148De30526A4863c0DcD](https://explorer.sirius.lightstreams.io/addr/0xdf81615e44b34c7015bf148de30526a4863c0dcd).
+ interested in the growth of the project.
 
-After that users can request more tokens for their accounts contacting Lightstreams Dev Team
+Once users exceeds the initial 10 PHTs they can request more tokens for their accounts contacting Lightstreams Dev Team
 either [Telegram](https://t.me/LightstreamsDevelopers) or on the [Discuss forum](https://discuss.lightstreams.network/c/dev)
 
 ## Getting started
 
-This application is split into two independent parts:
-- [Server](/server/README.md) NodeJS express server connected to Lightstreams node
-- [UI](/app/README.md) React application connected to Dashboard server.
+This application is split into two separated projects. A [NodeJS server](/server/README.md)
+which is connected to the lightstreams smart vault, and a [user interface](/app/README.md)
+implemented in React and connected to NodeJS server.
 
 
 ### License

app/README.md

@@ -16,14 +16,8 @@ $> cp .env.sample .env
 
 ## Configure server
 At `.env` file you can define the `SERVER_URL` which is going to act as the server
-side of your application.
-
-### Alternative 1: Remote server
-Lightstreams team provides its own server: `https://demo.dashboard.lightstreams.io`
-
-### Alternative 2: Local Server
-
-In case you want to run a local alternative [follow this.](/server/README.md).
+side of your application. [Follow the instractions](/server/README.md)
+to run your local dashboard server.
 
 ## Getting started