f point to params for formulas

Author: TheBlueMatt

lightning/src/routing/scoring.rs

@@ -323,9 +323,10 @@ type ConfiguredTime = Eternity;
 /// *Optimally Reliable & Cheap Payment Flows on the Lightning Network* by Rene Pickhardt
 /// and Stefan Richter [[1]] (i.e. `(payment amount + lower-bound) / (upper-bound - lower-bound)`).
 ///
-/// This probability is converted into a linear score by `log10`'ing it and multiplying it with the
+/// This probability is converted into a linear score and multiplying it with the
 /// [`liquidity_penalty_multiplier_msat`] and [`liquidity_penalty_amount_multiplier_msat`]
-/// parameters to get a concrete msat value.
+/// parameters to get a concrete msat value. See the documentation for those parameters for the
+/// exact formulas.
 ///
 /// The liquidity bounds are then decayed by halving them every [`liquidity_offset_half_life`].
 ///
@@ -397,6 +398,8 @@ pub struct ProbabilisticScoringParameters {
 	/// uncertainty bounds of the channel liquidity balance. Amounts above the upper bound will
 	/// result in a `u64::max_value` penalty, however.
 	///
+	/// `-log10(success_probability) * liquidity_penalty_multiplier_msat`
+	///
 	/// Default value: 40,000 msat
 	///
 	/// [`liquidity_offset_half_life`]: Self::liquidity_offset_half_life