Merge pull request #365 from 1inch/audit/oz-l-02

[SC-1465] Add Incomplete Docstrings

Author: zZoMROT

contracts/interfaces/IAmountGetter.sol

@@ -18,6 +18,7 @@ interface IAmountGetter {
      * @param takingAmount Actual taking amount
      * @param remainingMakingAmount Order remaining making amount
      * @param extraData Extra data
+     * @return makingAmount Actual making amount that should be used for the order
      */
     function getMakingAmount(
         IOrderMixin.Order calldata order,
@@ -38,6 +39,7 @@ interface IAmountGetter {
      * @param makingAmount Actual taking amount
      * @param remainingMakingAmount Order remaining making amount
      * @param extraData Extra data
+     * @return takingAmount Actual taking amount that should be used for the order
      */
     function getTakingAmount(
         IOrderMixin.Order calldata order,

contracts/interfaces/IOrderMixin.sol

@@ -82,13 +82,15 @@ interface IOrderMixin {
 
     /**
      * @notice Returns bitmask for double-spend invalidators based on lowest byte of order.info and filled quotes
+     * @param maker Address of the order maker
      * @param orderHash Hash of the order
      * @return remaining Remaining amount of the order
      */
     function remainingInvalidatorForOrder(address maker, bytes32 orderHash) external view returns(uint256 remaining);
 
     /**
      * @notice Returns bitmask for double-spend invalidators based on lowest byte of order.info and filled quotes
+     * @param maker Address of the order maker
      * @param orderHash Hash of the order
      * @return remainingRaw Inverse of the remaining amount of the order if order was filled at least once, otherwise 0
      */