f clearer comment, maybe

Author: TheBlueMatt

lightning/src/routing/scoring.rs

@@ -1751,11 +1751,13 @@ mod bucketed_history {
 		pub(super) fn calculate_success_probability_times_billion<T: Time>(
 			&self, now: T, last_updated: T, half_life: Duration, amount_msat: u64, capacity_msat: u64)
 		-> Option<u64> {
-			// If historical penalties are enabled, calculate the penalty by walking the set of
-			// historical liquidity bucket (min, max) combinations (where min_idx < max_idx, as
-			// having a minimum above our maximum is an invalid state). For each combination,
-			// calculate the probability of success given our payment amount, then total the
-			// weighted average probability of success.
+			// If historical penalties are enabled, we try to calculate a probability of success
+			// given our historical distribution of min- and max-liquidity bounds in a channel.
+			// To do so, we walk the set of historical liquidity bucket (min, max) combinations
+			// (where min_idx < max_idx, as having a minimum above our maximum is an invalid
+			// state). For each pair, we calculate the probability as if the bucket's corresponding
+			// min- and max- liquidity bounds were our current liquidity bounds and then multiply
+			// that probability by the weight of the selected buckets.
 			let mut total_valid_points_tracked = 0;
 
 			let payment_pos = amount_to_pos(amount_msat, capacity_msat);