docs: natspec

src/SablierV2OpenEnded.sol

@@ -346,7 +346,7 @@ contract SablierV2OpenEnded is
         }
     }
 
-    /// @dev Calculates the streamed amount.
+    /// @dev Calculates the streamed amount since last update.
     function _streamedAmountOf(uint256 streamId, uint40 time) internal view returns (uint128) {
         uint40 lastTimeUpdate = _streams[streamId].lastTimeUpdate;
 
@@ -355,7 +355,7 @@ contract SablierV2OpenEnded is
             return 0;
         }
 
-        // Calculate the amount streamed since last update. Each number is normalized to 18 decimals.
+        // Calculate the amount streamed since last update. Each value is normalized to 18 decimals.
         unchecked {
             // Calculate how much time has passed since the last update.
             uint128 elapsedTime = time - lastTimeUpdate;
@@ -424,10 +424,10 @@ contract SablierV2OpenEnded is
         // Effect: update the stream time.
         _updateTime(streamId, uint40(block.timestamp));
 
-        // Effect: sum up the remaining amount that the recipient is able to withdraw.
+        // Effect: update the remaining amount with the streamed amount.
         _streams[streamId].remainingAmount += recipientAmount;
 
-        // Effect: change the rate per second.
+        // Effect: update the rate per second.
         _streams[streamId].ratePerSecond = newRatePerSecond;
 
         // Log the adjustment.

src/types/DataTypes.sol

@@ -12,7 +12,8 @@ library OpenEnded {
     /// subtracted by the sum of withdrawn amounts, denoted in 18 decimals.
     /// @param ratePerSecond The amount of assets that is increasing by every second, denoted in 18 decimals.
     /// @param sender The address streaming the assets, with the ability to pause the stream.
-    /// @param lastTimeUpdate The Unix timestamp for the streamed amount calculation.
+    /// @param lastTimeUpdate The Unix timestamp which gets updated in {_adjustRatePerSecond}, {_restartStream} and
+    /// {_withdrawAt} through {_updateTime} .
     /// @param isStream Boolean indicating if the struct entity exists.
     /// @param isPaused Boolean indicating if the stream is paused.
     /// @param isTransferable Boolean indicating if the stream NFT is transferable.