diff --git a/tools/cordova/project.js b/tools/cordova/project.js
index 4207d338f6..5e15031d4f 100644
--- a/tools/cordova/project.js
+++ b/tools/cordova/project.js
@@ -44,6 +44,9 @@ function log(...args) {
   Console.rawInfo(`%% ${util.format.apply(null, args)}\n`);
 }
 
+// We pin platform versions ourselves instead of relying on cordova-lib
+// so we we can update them independently (e.g. use Cordova iOS 4.0.1
+// with Cordova 5.4.1)
 const pinnedPlatformVersions = {
   'android': '5.0.0',
   'ios': '4.0.1'