diff --git a/contracts/lendingpool/LendingPoolConfigurator.sol b/contracts/lendingpool/LendingPoolConfigurator.sol
index c9a828de..098987b9 100644
--- a/contracts/lendingpool/LendingPoolConfigurator.sol
+++ b/contracts/lendingpool/LendingPoolConfigurator.sol
@@ -365,11 +365,13 @@ contract LendingPoolConfigurator is VersionedInitializable {
   }
 
   /**
-   * @dev configures the reserve collateralization parameters
+   * @dev configures the reserve collateralization parameters.
+   * all the values are expressed in percentages with two decimals of precision. A valid value is 10000, which means 100.00%
    * @param asset the address of the reserve
    * @param ltv the loan to value of the asset when used as collateral
    * @param liquidationThreshold the threshold at which loans using this asset as collateral will be considered undercollateralized
-   * @param liquidationBonus the bonus liquidators receive to liquidate this asset
+   * @param liquidationBonus the bonus liquidators receive to liquidate this asset. The values is always above 100%. A value of 105%
+   * means the liquidator will receive a 5% bonus
    **/
   function configureReserveAsCollateral(
     address asset,
diff --git a/contracts/libraries/configuration/ReserveConfiguration.sol b/contracts/libraries/configuration/ReserveConfiguration.sol
index 7951d91a..71c64bde 100644
--- a/contracts/libraries/configuration/ReserveConfiguration.sol
+++ b/contracts/libraries/configuration/ReserveConfiguration.sol
@@ -86,7 +86,7 @@ library ReserveConfiguration {
   }
 
   /**
-   * @dev gets the Loan to Value of the reserve
+   * @dev gets the liquidation threshold of the reserve
    * @param self the reserve configuration
    * @return the liquidation threshold
    **/
diff --git a/contracts/libraries/logic/ReserveLogic.sol b/contracts/libraries/logic/ReserveLogic.sol
index 63cc0dd6..96cdbc40 100644
--- a/contracts/libraries/logic/ReserveLogic.sol
+++ b/contracts/libraries/logic/ReserveLogic.sol
@@ -76,7 +76,7 @@ library ReserveLogic {
   /**
    * @dev returns the ongoing normalized income for the reserve.
    * a value of 1e27 means there is no income. As time passes, the income is accrued.
-   * A value of 2*1e27 means for each unit of assset two units of income have been accrued.
+   * A value of 2*1e27 means for each unit of asset one unit of income has been accrued.
    * @param reserve the reserve object
    * @return the normalized income. expressed in ray
    **/