Fix comments, propTypes, and JSDocs

src/components/ReportActionItem/IOUAction.js

@@ -21,9 +21,6 @@ const propTypes = {
     /** The associated chatReport */
     chatReportID: PropTypes.string.isRequired,
 
-    /** The associated chatReport */
-    iouReportID: PropTypes.string.isRequired,
-
     /** Is this IOUACTION the most recent? */
     isMostRecentIOUReportAction: PropTypes.bool.isRequired,
 
@@ -49,6 +46,9 @@ const propTypes = {
     /** Whether the IOU is hovered so we can modify its style */
     isHovered: PropTypes.bool,
 
+    network: {
+        isOffline: PropTypes.bool,
+    }.isRequired,
 };
 
 const defaultProps = {

src/libs/IOUUtils.js

@@ -64,6 +64,17 @@ function updateIOUOwnerAndTotal(iouReport, actorEmail, amount, currency, type =
     return iouReportUpdate;
 }
 
+/**
+ * Returns the list of IOU actions
+ *
+ * @param {Array} reportIOUActions
+ * @param {Object} iouReport
+ * @param {String} type - IOUReportAction type. Can be oneOf(create, decline, cancel, pay, split)
+ * @param {String} pendingAction
+ * @param {Boolean} filterRequestsInDifferentCurrency
+ *
+ * @returns {Array}
+ */
 function getIOUReportActions(reportIOUActions, iouReport, type, pendingAction = '', filterRequestsInDifferentCurrency = false) {
     return _.chain(reportIOUActions)
         .filter(action => action.originalMessage
@@ -74,6 +85,15 @@ function getIOUReportActions(reportIOUActions, iouReport, type, pendingAction =
         .value();
 }
 
+/**
+ * Returns whether or not an IOU report contains money requests in a different currency
+ * that are either created or cancelled offline, and thus haven't been converted to the report's currency yet
+ *
+ * @param {Array} reportActions
+ * @param {Object} iouReport
+ *
+ * @returns {Boolean}
+ */
 function isIOUReportPendingCurrencyConversion(reportActions, iouReport) {
     // Pending money requests that are in a different currency
     const pendingRequestsInDifferentCurrency = _.chain(getIOUReportActions(

src/libs/actions/IOU.js

@@ -557,6 +557,7 @@ function splitBillAndOpenReport(participants, currentUserLogin, amount, comment,
  * @param {String} iouReportID
  * @param {String} type - cancel|decline
  * @param {Object} moneyRequestAction - the create IOU reportAction we are cancelling
+ * @param {Array} reportActions - the chat report's reportActions
  */
 function cancelMoneyRequest(chatReportID, iouReportID, type, moneyRequestAction, reportActions) {
     const chatReport = chatReports[`${ONYXKEYS.COLLECTION.REPORT}${chatReportID}`];