diff --git a/lib/database/adapters/RunAdapter.js b/lib/database/adapters/RunAdapter.js
index 0211f7bbef..31c891dbf3 100644
--- a/lib/database/adapters/RunAdapter.js
+++ b/lib/database/adapters/RunAdapter.js
@@ -15,6 +15,12 @@ const { PhysicalConstant } = require('../../domain/enums/PhysicalConstant');
 
 /**
  * Extract number of colliding LHC bunch crossing (for ALICE) from LHC fill schema
+ * Normally this information should be retrieved from LHC Interface,
+ * but in case it is not available we try to extract it from the filling schema name
+ * using the convention, where we are interested in the AliceBunches:
+ * @example
+ * {a}_{totalBunches}_{CMS&AtlasBunches}_{AliceBunches}_{...}
+ * Example: "100ns_432b_374_250_181_28bpi_27inj_VdMPbPb" => 250 colliding bunch crossings for ALICE
  * @param {string} fillingSchema filling schema
  * @return {number} number of colliding LHC bunch crossing
  */
diff --git a/lib/database/models/typedefs/SequelizeLhcFill.js b/lib/database/models/typedefs/SequelizeLhcFill.js
index b6de3e6cbd..49f013d1ea 100644
--- a/lib/database/models/typedefs/SequelizeLhcFill.js
+++ b/lib/database/models/typedefs/SequelizeLhcFill.js
@@ -20,8 +20,8 @@
  * @property {number|null} stableBeamsDuration
  * @property {string|null} beamType
  * @property {string|null} fillingSchemeName
- * @property {number|null} collidingBunchesCount
- * @property {number|null} deliveredLuminosity
+ * @property {number|null} collidingBunchesCount - property sent by LHC Interface
+ * @property {number|null} deliveredLuminosity - property sent by LHC Interface
  * @property {string} createdAt
  * @property {string} updatedAt
  * @property {SequelizeLhcFillStatistics|null} statistics