diff --git a/src/periphery/IonLens.sol b/src/periphery/IonLens.sol
index 37bfc3b2..79141948 100644
--- a/src/periphery/IonLens.sol
+++ b/src/periphery/IonLens.sol
@@ -93,7 +93,7 @@ contract IonLens is IIonLens {
     }
 
     /**
-     * @return The total amount of collateral in the pool.
+     * @return The total amount of collateral types in the pool.
      */
     function ilkCount(IIonPool pool) external view returns (uint256) {
         IonPoolStorage storage $ = _getIonPoolStorage();
diff --git a/src/vault/Vault.sol b/src/vault/Vault.sol
index 0401411b..92d651dd 100644
--- a/src/vault/Vault.sol
+++ b/src/vault/Vault.sol
@@ -319,8 +319,8 @@ contract Vault is ERC4626, Multicall, AccessControlDefaultAdminRules, Reentrancy
 
     /**
      * @notice Update allocation caps for specified IonPools or the IDLE pool.
-     * @dev The allocation caps are applied to pools in the order of the array
-     * within `supportedMarkets`. The elements inside `ionPools` must exist in
+     * @dev The allocation caps are applied to pools in the order of the
+     * `ionPool` array argument. The elements inside `ionPools` must exist in
      * `supportedMarkets`. To update the `IDLE` pool, use the `IDLE` constant
      * address.
      * @param ionPools The array of IonPools whose caps will be updated.