f more details, a bit more accurate description

Author: TheBlueMatt

lightning/src/routing/scoring.rs

@@ -796,10 +796,16 @@ impl<G: Deref<Target = NetworkGraph<L>>, L: Deref, T: Time> ProbabilisticScorerU
 	/// Query the historical estimated minimum and maximum liquidity available for sending a
 	/// payment over the channel with `scid` towards the given `target` node.
 	///
-	/// Returns two sets of 8 buckets. The first set describes the probability that the liquidity
-	/// lower-bound is in a given octile, the second describes the probability that the liquidity
-	/// upper-bound is in a given octile. Each bucket holds a `u16` representing the relative
-	/// probability of the bound being in the given octile.
+	/// Returns two sets of 8 buckets. The first set describes the octiles in which we've seen our
+	/// lower-bound liquidity estimates, the second set describes the octiles in which we've seen
+	/// our upper-bound liquidity estimates. Each bucket describes the relative frequency at which
+	/// we've seen a liquidity bound in the octile relative to the channel's total capacity, on an
+	/// arbitrary scale. Because the values are slowly decayed, more recent data points count for
+	/// more than older datapoints.
+	///
+	/// When scoring, the estimated probability that an upper-/lower-bound lies in a given octile
+	/// relative to the channel's total capacity is calculated by dividing that bucket's value with
+	/// the total of all buckets for the given bound.
 	///
 	/// For example, a value of `[0, 0, 0, 0, 0, 0, 32]` indicates that we belive the probability
 	/// of a bound being in the top octile to be 100%, and have never (recently) seen it in any