📖 update documentation

Author: skywinder

README.md

@@ -17,14 +17,12 @@
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 
+- [Core features](#core-features)
 - [Installation](#installation)
+  - [Example usage](#example-usage)
   - [Requirements](#requirements)
   - [Migration Guides](#migration-guides)
 - [Documentation](#documentation)
-  - [Examples](#examples)
-    - [Web3View example](#web3view-example)
-- [FAQ](#faq)
-  - [Core features:](#core-features)
 - [Projects that are using web3swift](#projects-that-are-using-web3swift)
 - [Support](#support)
 - [Contribute](#contribute)
@@ -35,6 +33,32 @@
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
+## Core features
+
+- [x] :zap: Swift implementation of [web3.js](https://github.com/ethereum/web3.js/) functionality 
+- [x] :thought_balloon: Interaction with remote node via **JSON RPC** 
+- [x] 🔐 Local **keystore management** (`geth` compatible)
+- [x] 🤖 Smart-contract **ABI parsing** 
+- [x] 🔓**ABI deconding** (V2 is supported with return of structures from public functions. Part of 0.4.22 Solidity compiler)
+- [x] 🕸Ethereum Name Service **(ENS) support** - a secure & decentralised way to address resources both on and off the blockchain using simple, human-readable names
+- [x] :arrows_counterclockwise: **Smart contracts interactions** (read/write) 
+- [x]  ⛩ **Infura support**, patial Websockets API support
+- [x] ⚒  **Parsing TxPool** content into native values (ethereum addresses and transactions) - easy to get pending transactions
+- [x] 🖇 **Event loops** functionality
+- [x] 📱Supports Web3View functionality (WKWebView with **injected "web3" provider**)
+- [x] 🕵️‍♂️ Possibility to **add or remove "middleware" that intercepts**, modifies and even **cancel transaction** workflow on stages "before assembly", "after assembly"and "before submission"
+- [x] ✅**Literally following the standards** (BIP, EIP, etc):
+
+    - [x] **[BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) (HD Wallets), [BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki) (Seed phrases), [BIP44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki) (Key generation prefixes)**
+- [x] **[EIP-20](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md)** (Standart interface for tokens - ERC-20), **[EIP-67](https://github.com/ethereum/EIPs/issues/67)** (Standard URI scheme), **[EIP-155](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-155.md)** (Replay attacks protection)
+    - [x] **And many others ** *(For more details about this EIP's look at [Documentation page](https://github.com/matter-labs/web3swift/blob/master/Documentation/))*: EIP-681, EIP-721, EIP-165, EIP-777, EIP-820, EIP-888, EIP-1400, EIP-1410, EIP-1594, EIP-1643, EIP-1644, EIP-1633, EIP-721, EIP-1155, EIP-1376, ST-20
+
+- [x] 🗜 **Batched requests** in concurrent mode
+- [x] **RLP encoding**
+- [x] Base58 encoding scheme
+- [x] Formatting to and from Ethereum Units
+- [x] Comprehensive Unit and Integration Test Coverage
+
 ## Installation
 
 - CocoaPods
@@ -92,7 +116,18 @@ github "matter-labs/web3swift" "master"
 
 Run `carthage update` to build the framework. By default, Carthage performs checkouts and creates a new directory 'Carthage' in the same location as your Cartfile. Open this directory, go to 'Build' directory, choose iOS or macOS directory, and use the selected directory framework in your Xcode project.
 
+### Example usage
 
+**Web3View example:**
+
+You can see how to our demo project: **WKWebView with injected "web3" provider**:
+
+``` bash
+git clone https://github.com/matter-labs/web3swift.git
+cd web3swift/Example/web3swiftBrowser
+pod install
+open ./web3swiftBrowser.xcworkspace
+```
 ### Requirements
 
 - iOS 9.0+ / macOS 10.11+
@@ -103,14 +138,14 @@ Run `carthage update` to build the framework. By default, Carthage performs chec
 
 - [web3swift 2.0 Migration Guide](https://github.com/matterinc/web3swift/blob/master/Documentation/web3swift%202.0%20Migration%20Guide.md)
 
-
----
 ## Documentation
 
 For full documentation details and FAQ, please look at [Documentation](https://github.com/matter-labs/web3swift/blob/master/Documentation/)
 
 *If you need to find or understand an API, check [Usage.md](https://github.com/matter-labs/web3swift/blob/master/Documentation/Usage.md).*
 
+ **FAQ moved [Documentation Page](https://github.com/matter-labs/web3swift/blob/master/Documentation/)**
+
 Here are quick references for essential features:
 
 - [Preffered models](https://github.com/matter-labs/web3swift/blob/master/Documentation/Usage.md#preffered-models)
@@ -119,49 +154,6 @@ Here are quick references for essential features:
 - [Websockets](https://github.com/matter-labs/web3swift/blob/master/Documentation/Usage.md#websockets)
 - [ENS](https://github.com/matter-labs/web3swift/blob/master/Documentation/Usage.md#ens)
 
-### Examples
-
-#### Web3View example
-
-You can see how to our demo project: **WKWebView with injected "web3" provider**:
-
-- Clone: `git clone https://github.com/matter-labs/web3swift.git`
-  -  `cd web3swift/Example/web3swiftBrowser`
-- Install Dependencies: `pod install`
-- Open: `open ./web3swiftBrowser.xcworkspace`
-
-## FAQ
-(Moved [Documentation Page](https://github.com/matter-labs/web3swift/blob/master/Documentation/))
-
-
-### Core features:
-
-- [x] Swift implementation of [web3.js](https://github.com/ethereum/web3.js/) functionality :zap:
-- [x] Interaction with remote node via **JSON RPC** :thought_balloon:
-- [x] Local **keystore management** (`geth` compatible)
-- [x] Smart-contract **ABI parsing** :book:
-- [x] **ABI deconding** (V2 is supported with return of structures from public functions. Part of 0.4.22 Solidity compiler)
-- [x] Ethereum Name Service **(ENS) support** - a secure & decentralised way to address resources both on and off the blockchain using simple, human-readable names
-- [x] **Smart contracts interactions** (read/write) :arrows_counterclockwise:
-- [x] Complete **Infura support**, patial Websockets API support
-- [x] **Parsing TxPool** content into native values (ethereum addresses and transactions) - easy to get pending transactions
-- [x] **Event loops** functionality
-- [x] Supports Web3View functionality (WKWebView with **injected "web3" provider**)
-- [x] Possibility to **add or remove "middleware" that intercepts**, modifies and even **cancel transaction** workflow on stages "before assembly", "after assembly"and "before submission"
-- [x] **Literally following the standards** (BIP, EIP, etc):
-
-    - [x] **[BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) (HD Wallets), [BIP39](https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki) (Seed phrases), [BIP44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki) (Key generation prefixes)**
-- [x] **[EIP-20](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md)** (Standart interface for tokens - ERC-20), **[EIP-67](https://github.com/ethereum/EIPs/issues/67)** (Standard URI scheme), **[EIP-155](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-155.md)** (Replay attacks protection)
-    - [x] **And many others ** *(For more details about this EIP's look at [Documentation page](https://github.com/matter-labs/web3swift/blob/master/Documentation/))*: EIP-681, EIP-721, EIP-165, EIP-777, EIP-820, EIP-888, EIP-1400, EIP-1410, EIP-1594, EIP-1643, EIP-1644, EIP-1633, EIP-721, EIP-1155, EIP-1376, ST-20
-
-
-- [x] **Batched requests** in concurrent mode
-- [x] **RLP encoding**
-- [x] Base58 encoding scheme
-- [x] Formatting to and from Ethereum Units
-- [x] Comprehensive Unit and Integration Test Coverage
-
-
 ## Projects that are using web3swift
 
 If you are using this library in your project, please [add a link](https://github.com/matter-labs/web3swift/edit/develop/README.md) to this repo.