Merge branch 'docs' into dev

* docs:
  add validators transaction explanation
  add troubleshooting section
  add validators rewards block to docs

docs/install.rst

@@ -124,3 +124,13 @@ Run Minter
     :lineno-start: 13
 
     minter
+
+Troubleshooting
+---------------
+
+Too many open files (24)
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Tendermint sometimes is very resource-demanding in terms of "max open files limit". If your
+instance is constantly shutting down after working couple minutes - try to increase open files limit:
+`<https://easyengine.io/tutorials/linux/increase-open-files-limit/>`__

docs/validators.rst

@@ -40,7 +40,13 @@ Recommended:
 Rewards
 ^^^^^^^
 
-...
+Rewards for blocks and commissions are accumulated and proportionally (based on stake value)
+payed once per 12 blocks (approx 1 minute) to all active validators (and their delegators).
+
+Delegators receive their rewards at the same time after paying commission to their validators
+(commission value is based on validator's settings).
+
+5% from reward going to DAO account.
 
 Rules and fines
 ^^^^^^^^^^^^^^^
@@ -70,6 +76,9 @@ How to become validator in testnet
     P.S. You can receive testnet coins in our telegram wallet @BipWallet_Bot.
 
     4.1. Declare candidacy
+        Validators should declare their candidacy, after which users can delegate
+        and, if they so wish, unbond. Then declaring candidacy validator should fill a form:
+
         - Address - You will receive rewards to this address and will be able to on/off your validator.
         - Public Key - Paste public key you created in step 2 *(Mp...)*.
         - Commission - Set commission for delegated stakes.
@@ -80,7 +89,12 @@ How to become validator in testnet
         :width: 300px
 
     4.2. Set candidate online
-        Public Key - Paste public key you created in step 2 *(Mp...)*.
+        Validator is **offline** by default. When offline, validator is not included in the list of
+        Minter Blockchain validators, so he is not receiving any rewards and cannot be punished
+        for low availability.
+
+        To turn your validator **on**, you should provide Public Key (which you created in step
+        2 *(Mp...)*).
 
         *Note: You should send transaction from address you choose in Address field in step 4.2*