f add missing paragraph in docs

Author: TheBlueMatt

lightning/src/routing/scoring.rs

@@ -424,9 +424,16 @@ pub struct ProbabilisticScoringParameters {
 	/// large payments. The penalty is computed as the product of this multiplier and the `2^20`ths
 	/// of the payment amount, weighted by the negative `log10` of the success probability.
 	///
+	/// This penalty is similar to [`liquidity_penalty_amount_multiplier_msat`], however, instead
+	/// of using only our latest estimate for the current liquidity available in the channel, it
+	/// estimates success probability based on the estimated liquidity available in the channel
+	/// through history. Specifically, every time we update our liquidity bounds on a given
+	/// channel, we track which of several buckets those bounds fall into, exponentially decaying
+	/// the probability of each bucket as new samples are added.
+	///
 	/// Default value: 64 msat
 	///
-	/// [`liquidity_penalty_multiplier_msat`]: Self::liquidity_penalty_multiplier_msat
+	/// [`liquidity_penalty_amount_multiplier_msat`]: Self::liquidity_penalty_amount_multiplier_msat
 	pub historical_liquidity_penalty_amount_multiplier_msat: u64,
 
 	/// Manual penalties used for the given nodes. Allows to set a particular penalty for a given